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Note to Readers 

This book introduces beginners to the principles of machine language: what it 
is, how It works, and how to program with it. 

It is based on an intensive two-day course on machine language that has been 
presented many times over the past five years. 

Readers of this book should have a computer on hand: students will learn by 
doing, not just by reading. Upon completing the tutorial material in this book, the 
reader will have a good idea of the fundamentals of machine language. There will 
be more to be learned; but by this time, students should understand how to adapt 
other material from books and magazines to their own particular computers. 



LIMITS OF LIABILITY AND 
DISCLAIMER OF WARRANTY 

The author and publisher of this book have used their best efforts in preparing 
this book and the programs contained in it. These efforts include the development, 
research, and testing of the programs to determine their effectiveness. The author 
and the publisher make no warranty of any kind, expressed or implied, with regard 
to these programs, the text, or the documentation contained in this book. The 
author and the publisher shall not be liable in any event for claims of incidental 
or consequential damages in connection with, or arising out of, the furnishing, 
performance, or use of the text or the programs. 

At time of publication, the Commodore 264 is still undergoing design changes. 
The name is being changed to the "PLUS/4", a related machine, the Commodore 
16, has also been announced. Detailed design information is not available; but 
the information given in this book for the Commodore 264 should be generally 
accurate. 



Note to Authors 

Do you have a manuscript or a software program related to personal 
computers? Do you have an idea for developing such a project? If so, we 
would like to hear from you. The Brady Co. produces a complete range of 
books and applications software for the personal computer market. We invite 
you to write to David Culvenwell, Publishing Director, Brady Communications 
Company Inc., Bowie, Maryland 20715. 
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Preface 



This book is primarily tutorial in nature. It contains, Inowever, extensive reference 
matenal, whicli tine reader will want to continue to use. 

No previous machine language experience is required. It is useful if the reader 
has had some background in programming in other languages, so that concepts 
such as loops and decisions are understood 

Beginners will find that the material in this book moves at a fast pace. Stay with 
it; if necessary, skip ahead to the examples and then come back to reread a difficult 
area. 

Readers with some machine language experience may find some of the material 
too easy; for example, they are probably quite familiar with hexadecimal notation 
and don't need to read that part. If this is the case, skip ahead. But do enter all 
the programming projects; if you have missed a point, you may spot it while doing 
an exercise. 

Programming students learn by doing. The beginner needs to learn simple things 
about his or her machine in order to feel in control. The elements that are needed 
may be itemized as: 

• Machine language. This is the objective, but you can't get there without the 
next two Items. 

• Machine architecture. All the machine language theory in the world will have 
little meaning unless the student knows such things as where a program may 
be placed in memory, how to print to the screen, or how to input from the 
keyboard. 

• Machine language tools. The use of a simple machine language monitor to 
read and change memory is vital to the objective of making the computer do 
something in machine language Use of a simple assembler and elements of 
debugging are easy once you know them; but until you know them, it's hard 
to make the machine do anything. 

Pnnciples of sound coding are important. They are seldom discussed explicitly, 
but run as an undercurrent through the material. The objective is this: it's easy to 
do things the right way, and more difficult to do them the wrong way. By introducing 
examples of good coding practices early, the student will not be motivated to look 
for a harder (and inferior) way of coding. 

It should be pointed out that this book deals primarily with machine language, 
not assembly language. Assembler programs are marvellous things, but they are 
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too advanced for the beginner. I prefer to see the student forming an idea of how 
the bytes of the program lie within memory. After this concept is firmly fixed in 
mind, he or she can then look to the greater power and flexibility offered by an 
assembler. 
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Introduction 

Why learn machine language? There are three reasons. First, for speed; ma- 
chine language programs are fast. Second, for versatility; all other languages are 
limited in some way, but not machine language. Third, for comprehension; since 
the computer really works in machine language only, the key to understanding 
how the machine operates is machine language. 

Is it hard? Not really. It's finicky, but not difficult. Individual machine language 
instructions don't do much, so we need many of them to do a job. But each 
instruction is simple, and anyone can understand it if he or she has the patience. 

Some programmers who started their careers in machine language find "higher 
level" languages such as BASIC quite difficult by comparison. To them, machine 
language instructions are simple and precise, whereas BASIC statements seem 
vague and poorly defined by comparison. 

Where will this book take you? You will end up with a good understanding of 
what machine language is, and the principles of how to program in it. You won't 
be an expert, but you'll have a good start and will no longer be frightened by this 
seemingly mysterious language. 

Will the skills you learn be transportable to other machines? Certainly. Once 
you understand the principles of programming, you'll be able to adapt. If you were 
to change to a non-Commodore machine that used the 6502 chip (such as Apple 
or Atari), you'd need to learn about the architecture of these machines and about 
their machine language monitors. They would be different, but the same pnnciples 
would apply on all of them. 

Even if you change to a computer that doesn't use a chip from the 6502 family, 
you wiJI be able to adapt. As you pick through the instructions and bits of the 
Commodore machine, you will have learned about the principles of all binary 
computers. You will need to learn the new microprocessor's instruction set, but it 
will be much easier the second time around. 

Do you need to be a BASIC expert before tackling machine language? Not at 
all. This book assumes you know a little about programming fundamentals: loops, 
branching, subroutines, and decision making. But you don't need to be an ad- 
vanced programmer to learn machine language. 
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This chapter discusses: 

• The inner workings of microcomputers 

• Computer notation: binary and hexadecimal 

• The 650x's inner architecture 

• Beginning use of a machine language monitor 

• A computer's "memory layout" 

• First machine language commands 

• Writing and entering a simple program 
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MACHINE LANGUAGE FOR COMMODORE MACHINES 



The Inner Workings of Microcomputers 

All computers contain a large number of electrical circuits. Within any 
binary computer, these circuits may be in only two states: "on" or "off." 

Technicians will tell you that "on" usually means full voltage on the circuit 
concerned, and "off" means no voltage. There's no need for volume control 
adjustments within a digital computer: each circuit is either fully on or fully 
off. 

The word "binary" means "based on two," and everything that happens 
within the computer is based on the two possibilities of each circuit: on or 
off. We can identify these two conditions in any of several ways: 

ON or OFF 
TRUE or FALSE 
YES or NO 
1 or 

The last description, 1 or 0, is quite useful. It is compact and numeric. If 
we had a group of eight circuits within the computer, some of which were 
"on" and others "off," we could describe their conditions with an expression 
such as: 

llDDDlll 

This would signify that the two leftmost wires were on, the next three off, 
and the remaining three on. The value 1 10001 1 1 looks like a number; in 
fact, It IS a binary number in which each digit is or 1 . It should not be 
confused with the equivalent decimal value of slightly over 1 1 million; the 
digits would look the same, but In decimal each digit could have a value 
from to 9. To avoid confusion with decimal numbers, binary numbers 
are often preceded by a percent sign, so that the number might be shown 
as ^llDDDlll . 

Each digit of a binary number is called a bit, which is short for "binary 
digit." The number shown above has eight bits; a group of eight bits is a 
byte. Bits are often numbered from the right, starting at zero. The right- 
hand bit of the above number would be called "bit 0," and the left-hand 
bit would be called "bit 7," This may seem odd, but there's a good math- 
ematical reason for using such a numbering scheme. 
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The Bus 

It's fairly common for a group of circuits to be used together. The wires 
run from one microchip to another, and then on to the next. Where a group 
of wires are used together and connect to several different points, the 
group IS called a bus (sometimes spelled "buss"). 

The PET, CBM, and VIC-20 use a microprocessor chip called the 6502. 
The Commodore 64 uses a 6510. The Commodore B senes uses a 6509 
chip, and the Commodore PLUS/4 uses a chip called 7501 . All these chips 
are similar, and there are other chips in the same family with numbers like 
6504; every one works on the same principles, and we'll refer to all of 
them by the family name 650x. 

Let's take an example of a bus used on any 650x chip. A 650x chip has 
little built-in storage. To get an instruction or perform a computation, the 
650x must call up information from "memory"— data stored within other 
chips. 

The 650x sends out a "call" to all memory chips, asking for information. 
It does this by sending out voltages on a group of sixteen wires called the 
"address bus." Each of the sixteen wires may carry either voltage or no 
voltage; this combination of signals is called an address. 

Every memory chip is connected to the address bus. Each chip reads the 
address, the combination of voltages sent by the processor. One and only 
one Chip says, ' That's me!" In other words, the specific address causes 
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that chip to be selected; it prepares to communicate with the 650x. All 
other chips say, "That's not me!" and will not participate in data transfer. 

The Data Bus 

Once the 650x microprocessor has sent an address over the address bus 
and It has been recognized by a memory chip, data may tiow between 
memory and 650x. This data is eight bits (it flows over eight wires). It 
might look like this: 

The data might flow either way. That is, the 650x might read from the 
memory chip, in which case the selected memory chip places information 
onto the data bus which is read by the microprocessor. Alternatively, the 
650x might wish to write to the memory chip. In this case, the 650x places 
information onto the data bus, and the selected memory chip receives the 
data and stores it. 
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Figure 1.2: Two-way data bus 

All Other chips are still connected to the data bus, but they have not been 
selected, so they ignore the information. 

The address bus is accompanied by a few extra wires (sometimes called 
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the control bus) that control such things as data timing and the direction 
in which the data should flow: read or write. 

Number Ranges 

The address bus has sixteen bits, each of which might be on or off. The 
possible combinations number 65536 (two raised to the sixteenth power). 
We then have 65536 different possibilities of voltages, or 65536 different 
addresses. 

The data bus has eight bits, which allows for 256 possibilities of voltages. 
Each memory location can store only 256 distinct values. 

It is often convenient to refer to an address as a decimal number. This is 
especially true for PEEK and POKE statements in the BASIC language. 
We may do this by giving each bit a "weight." Bit zero (at the nght) has 
a weight of 1 ; each bit to the left has a weight of double the amount, so 
that bit 15 (at the left) has a weight of 32768. Thus, a binary address such 
as 

□□□inniDiDiniinn 

has a value of 4096 + 512 + 128 + 32 + 8 + 4 or 4780. A POKE to 4780 
decimal would use the above binary address to reach the correct part of 
memory. 
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Figure 1.3 

Direct conversion between decimal and binary is seldom needed. Such 
conversions usually pass through an intermediate number system, called 
hexadecimal. 

Hexadecimal Notation 

Binary is an excellent system for the computer, but it is inconvenient for 
most programmers. If one programmer asks another, "What address should 
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I use for some activity?", an answer such as "Address 
^□□□IDDIDIDIDIIDD" might be correct but would probably be un- 
satisfactory. There are too many digits. 

Hexadecimal is a code used by humans to conveniently represent binary 
numbers. The computer uses binary, not hexadecimal; programmers use 
hexadecimal because binary is cumbersome. 

To represent a binary number in hexadecimal, the bits must be grouped 
together four at a time. If we take the binary value given above and split 
it into groups of four, we get 

□ □□1 HDD 

Now each group of four bits is represented by a digit as shown in the 
following table: 

□ □IDD--^ ID □□-a IIDD-C 
□□□1-1 □l^l-S 1^^1-q 11^1-D 
□□l^-2 □ll^-b I^IQ-A lllQ-E 
□□11-3 □111-7 IQll-B 1111-F 

Thus, the number would be represented as hexadecimal IE AC. A dollar 
sign is often prefixed to a hexadecimal number so that it may be clearly 
recognized:$lEAC. 

The same type of weighting is applied to each bit of the group of four as 
was described before. In other words, the rightmost bit (bit zero) has a 
weight of 1, the next left a weight of 2, the next a weight of 4, and the 
leftmost bit (bit three) a weight of 8. If the total of the weighted bits exceeds 
nine, an alphabetic letter is used as a digit: A represents ten; B, eleven; 
C, twelve; and F, fifteen. 

Eight-bit numbers are represented with two hexadecimal digits. Thus, 
^□l^llQll may be written as $5B. 

Hexadecimal to Decimal 

As we have seen, hexadecimal and binary numbers are easily inter- 
changeable. Although we will usually write values in "hex," occasionally 
we will need to examine them in their true binary state to see a particular 
information bit. 

Hexadecimal isn't hard to translate into decimal. You may recall that in 
early arithmetic we were taught that the number 24 meant, "two tens and 
four units." Similarly, hexadecimal 24 means "two sixteens and four units," 
or a decimal value of 36. By the way, it's better to say hex numbers as 
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"two four" rather than "twenty-four," to avoid confusion with decimal val- 
ues. 

The formal procedure, or algorithm, to go from hex to decimal is as follows. 

Step 1 . Take the leftmost digit; if it's a letter A to F , convert it to the appropriate 
numeric value (A equals ID, B equals 11, and so on) 

Step 2* If there are no more digits, you're finished, you have the number. Stop. 

Step 3: Multiply the value so far by sixteen. Add the next digit to the result, 
converting letters if needed Go back to step 2 

Using the above steps, let's convert the hexadecimal number $12 AC. 

Step 1 • The leftmost digit is 1. 

Step 2: There are more digits, so we'll continue. 

Step 3 1 times lb is lb, plus 2 gives Ifi. 

Step 2* More digits to come. 

Step 3' Ifi times lb is 2fifi, plus ID (for A) gives 2*=lfi 

Step 2: More digits to come. 

Step 3. 2Rfi X lb IS ^7bfi, plus 12 (for C) gives ^7fiD. 

Step 2: No more digits: ^7fiD is the decimal value 

This is easy to do by hand or with a calculator. 

Decimal to Hexadecimal 

The most straightforward method to convert from decimal to hexadecimal 
is to divide repeatedly by 16; after each division, the remainder is the next 
hexadecimal digit, working from right to left. This method is not too well 
suited to small calculators, which usually don't give remainders. The fol- 
lowing fraction table may offer some help: 

.5 5DD-^ .5 □□□-a •7 5DD-C 

. DbES-l .3125-5 .5bE5-q .fllE5-D 

.12 5D-E .37 5D-b .b25D-A .fl7 5D-E 

.1575-3 .^375-7 .bfl75-B •q375-F 

If we were to translate 4780 using this method, we would divide by 16, 
giving 298.75. The fraction tells us the last digit is C; we now divide 298 
by 16, giving 18.625. The fraction corresponds to A, making the last two 
digits AC. Next we divide 18 by 16, getting 1.125— now the last three 
digits are 5 AC. We don't need to divide the one by 1 6, although that would 
work; we just put it on the front of the number to get an answer of $ 1 2 AC. 

There are other methods of performing decimal-to-hexadecimal conver- 
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sions. You may wish to look them up in a book on number systems. 
Alternatively, you may wish to buy a calculator that does the job electron- 
ically. Some programmers get so experienced that they can do conver- 
sions in their heads; I call them "hex nuts." 

Do not get fixed on the idea of numbers. Memory locations can always 
be described as binary numbers, and thus may be converted to decimal 
or hexadecimal at will. But they may not mean anything numenc. the 
memory location may contain an ASCH coded character, an instruction, 
or any of several other things. 

Memory Elements 

There are generally three types of devices attached to the memory busses 
(address, data, and control busses): 

• RAM. Random access memory. This Is the read and write memory, where 
we will store the programs we write, along with values used by the program 
We may store information into RAM, and may recall the information at any 
time 

• ROM. Read only memory. This is where the fixed routines are kept within the 
computer. We may not store information into ROM; its contents were fixed 
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when the ROM was made We will use program units (subroutines) stored in 
ROM to do special tasks for us, such as input and output. 

• I A. Interface adaptor chips These are not memory in the usual sense, but, 
these chips are assigned addresses on the address bus, so we call them 
"memory-mapped" devices Information may be passed to and from these 
devices, but the information is generally not stored in the conventional sense 
I A chips contain such functions as* input/output (I/O) interfaces that serve 
as connections to the "outside world", timing devices, interrupt control sys- 
tems, and sometimes specialized functions, such as video control or sound 
generation. I A chips come m a wide variety of designs, including the PI A 
(peripheral interface adaptor), the VIA (versatile interface adaptor), the CIA 
(complex interface adaptor), the VIC (video interface chip), and the SID 
(sound interface device). 

Within a given computer, some addresses may not be used at all. Some 
devices may respond to more than one address, so that they seem to be 
in two places in memory. 

An address may be thought of as split in two parts. One part, usually the 
high part of the address, selects the specific chip. The other part of the 
address selects a particular part of memory within the chip. For example, 
in the Commodore 64. the hex address $DD2D (decimal 53 2aD) sets 
the border color of the video screen The first part of the address (roughly, 
$DD . .) selects the video chip; the last part of the address (. . 2D) 
selects the part of the chip that controls border color. 

Microprocessor Registers 

Within the 650x chip are several storage areas called registers. Even 
though they hold infornnation, they are not considered "memory" since 
they don't have an address Six of the registers are important to us. Briefly, 
they are: 

PC: (16 bits) The program counter tells where the next 

instruction will come from. 

A, X and Y (8 bits each) These registers hold data. 

SR The status register, sometimes called PSW 

(processor status word), tells about the re- 
sults of recent tests, data handling, and so 
on. 

S P The stack pointer keeps track of a temporary ' 

storage area. 

We will talk about each of these registers in more detail lat^r. At the 
moment, we win concentrate on the PC (program counter). 
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Instruction Execution 

Suppose that the 650x is stopped (not an easy trick), and that there is a 
certain address, say $123^, in the PC. The moment we start the micro- 
computer, that address will be put out to the address bus as a read address, 
and the processor will add one to the value in the PC. 

Thus, the contents of address $123^ will be called for, and the PC will 
change to $1235. Whatever information comes in on the data bus will 
be taken to be an instruction. 

The microprocessor now has the instruction, which tells it to do something. 
The action is performed, and the whole action now repeats for the next 
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instruction. In otiier words, address $123 5 will be sent to nriemory, and 
the PC will be incremented to $123ti. 

You can see that the processor works in the same way that most computer 
languages do: an instruction is executed, and then the computer proceeds 
to the next instruction, and then the next, and so on. We can change the 
sequence of execution by means of a ' jump ' or "branch" to a new location, 
but normally, it's one instruction after another. 

Data Registers: A, X, and Y 

Any of three registers can be used to hold and manipulate eight bits of 
data. We may load information from memory into A, X, or Y; and we may 
store information into memory from any of A, X, or Y 

Both "load" and "store" are copying actions If I load A (LDA) from 
address $234 5, I make a copy of the contents of hex 234 5 into A; but 
234 5 still contains its previous value. Similarly, if I store Y into $34 5b, 
I make a copy of the contents of Y into that address; Y does not change. 

The 650x has no way of moving information directly from one memory 
address to another. Thus, this information must pass via A, X, or Y; we 
load it from the old address, and store it to the new address 

Later, the three registers will take on individual identities. For example, 
the A register is sometimes called the accumulator, since we perform 
addition and subtraction there. For the moment, they are interchantjeable: 
we may load to any of the three, and we may store from any of them. 

First Program Project 

Here's a programming task: locations $D3flD and $D3fll contain in- 
formation. We wish to write a program to exchange the contents of the 
two locations. How can we do this? 

We must make up a plan. We know that we cannot transfer information 
directly from memory to memory. We must load to a register, and then 
store. But there's more. We must not store and destroy data in memory 
until that data has been safely put away. How can we do this? 

Here's our plan. We may load one value into A (say, the contents of 
$D3flD), and load the other value into X (the contents of $D3fll). Then 
we could store A and X back, the other way around. 

We could have chosen a different pair of registers for our plan, of course: 
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A and Y, or X and Y. But let's stay with the original plan. We can code 
our plan in a more formal way: 

LDA $03 &n (bring in first value) 
LDX $ 03 fill (bring m second value) 
STA $D3fll (store in opposite place) 
STX $D3flD (and again) 

You will notice that we have coded "load A" as LDA, "load X" as 
LDX, "store A" as STA, and "store X" as STX. Every command 
has a standard three-letter abbreviation called a mnemonic. Had we used 
the Y register, we might have needed to use LDY and STY. 

One more command is needed. We must tell the computer to stop when 
it has finished the four instructions. In fact, we can't stop the computer; 
but if we use the command BRK (break), the computer will go to the 
machine language monitor (MLM) and wait for further instructions. We'll 
talk about the MLM in a few moments. 

We have written our program in a notation styled for human readability, 
called assembly language. But the computer doesn't understand this no- 
tation. We must translate it to machine language. 

The binary code for LDA is ^IDlDllDl, or hexadecimal AD. That's 
what the computer recognizes; that's the instruction we must place in 
memory. So we code the first line. 

AD aa 03 LDA $D3flD 

It's traditional to write the machine code on the left, and the source code 
on the right. Let's look closely at what has happened. 

LDA has been translated into $AD. This is the operation code, or op 
code, which says what to do. It will occupy one byte of memory. But we 
need to follow the instruction with the address from which we want the 
load to take place. That's address $D3flD; it's sixteen bits long, and so 
it will take two bytes to hold the address. We place the address of the 
instruction, called the operand, in memory immediately behind the instruc- 
tion. But there's a twist. The last byte comes first, so that address $ □ 3 fl □ 
IS stored as two bytes: flD first and then 03. 

This method of storing addresses— low byte first— is standard in the 650x. 
It seems unusual, but it's there for a good reason. That is, the computer 
gets extra speed from this "backwards" address. Get used to it; you'll see 
it again, many times 
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Here are some machine language op codes for the instructions we may 
use. You do not need to memorize them. 

LDA-AD LDX-ftE LDY-AC BRK-DD 

STA-fiD STX-fiE STY-flC 

Now we can complete the translation of our program. 



AD 


an 


□ 3 


LDA 


$D3flD 


AE 


fll 


□ 3 


LDX 


$D3fll 


flD 


fll 


□ 3 


STA 


$D3fll 


flE 


flO 


□ 3 


STX 


$D3flD 


□ □ 






BRK 





On the right, we have our plan. On the left, we have the actual program 
that wilt be stored in the computer. We may call the right side assembly 
code and the left side machine code, to distinguish between them. Some 
users call the right-hand information source code, since that's where we 
start to plan the program, and the left-hand program object code, since 
that's the object of the exercise— to get code into the computer. The job 
of translating from source code to object code is called assembly. We 
performed this translation by looking up the op codes and translating by 
hand; this is called hand assembly 

The code must be placed into the computer. It will consist of 13 bytes: 
AD an D3 AE fll 03 flD fll 03 flE flD 03 □□.That's the 
whole program. But we have a new question: where do we put it? 

Choosing a Location 

We must find a suitable location for our program. It must be placed into 
RAM memory, of course, but where? 

For the moment, we'll place our program into the cassette buffer, starting 
at address $^33C (decimal fl2fl). That's a good place to put short test 
programs, which is what we will be writing for a while. 

Now that we've made that decision, we face a new hurdle: how do we get 
the program in there? To do that, we need to use a machine language 
monitor. 

Monitors: What They Are 

Alt computers have a built-in set of programs called an operating system 
that gives the machine its styte and basic capabilities. The operating sys- 
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tem takes care of communications — reading tlie keyboard, making tlie 
proper tilings appear on tlie screen, and transferring data between tlie 
computer and otiier devices, sucli as disk, tape, or printer. 

Wlien we type on tlie computer keyboard, we use tlie operating system, 
whicli detects tlie cliaracters we type. But tliere's an extra set of programs 
built into the computer that must decide what we mean. When we are 
using the BASIC language, we'll be communicating with the BASIC mon- 
itor, which understands BASIC commands such as NEW, LOAD, LIST, 
or RUN. It contains editing features that allow us to change the BASIC 
program that we are writing. 

But when we switch to another system — often another language— we'll 
need to use a different monitor. Commands such as NEW or LIST don't 
have any meaning for a machine language program. We must leave the 
BASIC monitor and enter a new environment: the machine language mon- 
itor. We'll need to learn some new commands because we will be com- 
municating with the computer in a different way. 

The Machine Language Monitor 

Most PET/CBM computers have a simple MLM (machine language mon- 
itor) built in. it may be extended with extra commands. The Commodore 
PLUS/4 contains a very powerful MLM. The VIC-20 and Commodore 64 
do not have a built-in MLM, but one can be added. Such a monitor may 
be either loaded into RAM or plugged In as a cartridge. Monitors may be 
purchased or obtained from user clubs. 

Most machine language monitors work In a similar way, and have about 
the same commands. To proceed, you'll need an MLM in your computer. 
Use the built-in one, plug it In, load it in, or load and run . , , whatever the 
instructions tell you. On a PET/CBM machine, typing the command SYS 
A will usually switch you to the built-in monitor. After an MLM has been 
added to a VIC or Commodore 64. the command SYS fl will usually get 
you there. On the Commodore PLUS/4, the BASIC command MONITOR 
will bring the monitor into play. 

Monitor Display 

The moment you enter the ML M, you'll see a display that looks something 
like this: 
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B* 

PC SR AC XR YR SP 
. ; □□□5 20 5^ 23 bA Ffl 

The cursor will be flashing to the right of the period on the bottom line. 
The exact appearance of the screen information may vary according to 
the particular monitor you are using. Other material may be displayed — 
in particular, a value called IRQ— which we will ignore for the time being. 

The information you see may be interpreted as follows: 

B* — we have reached the MLM by means of a "break." More about that later 
PC — The value shown below this title is the contents of the program counter. 
This indicates where the program "stopped." In other words, if the value shown 
is address □□□5, the program stopped at address UUUA, since the PC is 
ready to continue at the following address. The exact value (UUUA versus 
□ □□5) may vary depending on the particular MLM. 

S R— The value shown below shows the status register, which tells us the results 
of recent tests and data operations We'd need to split apart the eight bits and 
look at them individually to establish all the information here, we will do this at 
a later time. 

AC, XR, and YR— The values shown beiow tnese three titles are the contents 
of our three data registers: A, X, and Y 

SP— The value shown below is that of the stack pointer, which indicates a 
temporary storage area that the program might use. A value of Ffl, for example, 
tens us that the next item to be dropped into the stack area would go to address 
$DlFa in memory More on this later. 

The period is roughly the equivalent of the READY statement in BASIC. 
It indicates that the computer is ready to receive a command from you. 

You will notice that the display printed by the monitor (called the register 
display) shows the internal registers within the 650x chip. Sometimes there 
is another item of information, titled IRQ, in this display. It doesn't belong, 
since it does not represent a microprocessor register. IRQ tells us to what 
address the computer will go if an interrupt occurs; this information is 
stored in memory, not within the 650x. 

MLM Commands 

The machine language monitor is now waiting for you to enter a command. 
The old BASIC commands don't work any more; LIST or NEW or SYS 
are not known to the MLM. We'll list some popular commands in a moment. 
First, let's discuss the command that takes us back to BASIC. 
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. X exits the MLM and returns to the BASIC monitor. Try it. Remember 
to press RETURN after you've typed the X, of course. You will return to 
the BASIC system, and the BASIC monitor wilt type READY. You're back 
in familiar territory. Now go back to the monitor with SYS^ or SYSfl or 
MONITOR as the case may be. BASIC ignores spaces: it doesn't matter 
if you type SYSfl or SYS fl; just use the right number for your machine 
for PET/CBM. fl for VIC/64). 

Remember: BASIC commands are no good in the MLM, and machine 
language monitor commands (such as . X) are no good in BASIC. At first, 
you'll give the wrong commands at the wrong time because it's hard to 
keep track of which monitor system is active If you type in an MLM 
command when you're in BASIC, you'll probably get a ? SYNTAX ERROR 
reply. If you type in a BASIC command when you're in the machine lan- 
guage monitor, you'll probably get a question mark in the line you typed. 

Some other MLM commands are as follows (the prompting period is in- 
cluded): 

.M IDID (display memory from hex 1 □ □ □ to 

IDID) 

. R (display registers ... again!) 

. G □ 3 3 C (go to □ 3 3 C and start running a pro- 

gram) 

Do not enter this last (. G) command. There is no program at address 
□ 33C yet, so the computer would execute random instructions and we 
would lose control. 

There are two other fundamental instructions that we won't use yet: they 
are . S for save and . L for load. These are tricky. Until you learn about 
BASIC pointers (Chapter 6), leave them alone. 

Displaying Memory Contents 

You'll notice that there is a command for displaying the contents of mem- 
ory, but there doesn't seem to be one for changing memory. You can do 
both, of course. 

Suppose we ask to display memory from $!□□□ to $!□!□ with the 
command 

.M IDID 

Be careful that you have exactly one space before each address. You 
might get a display that looks something like this: 
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11 3A EA □□ 21 32 DA AA 
.:lDDfl 2D AT) 2D 42 55 SA 

.:1D1D SA AS 52 4b 4q 45 4C 44 

The four-digit number at trie start of each line represents the address in 
memory being displayed. The two-digit numbers to the right represent the 
contents of memory. Keep in mind that all numbers used by the machine 
language monitor are hexadecimal. 

In the example above, $1DDD contains a value of $11;$1DD1 contains 
a value of $3 A; and so on, until $1DD7, which contains a value of $AA. 
We continue with address $lDDfl on the next line. Most monitors show 
eight memory locations on each line, although some VIC-20 monitors show 
only five because of the narrow screen. 

We asked for memory locations up to address $1D1D only; but we get 
the contents of locations up to $1D17 in this case The monitor always 
fills out a line, even if you don't ask for the extra values. 

Changing Memory Contents 

Once we have displayed the contents of part of memory, we can change 
that part of memory easily. All we need to do is to move the cursor until 
It IS positioned over the memory contents in question, type over the value 
displayed, and then press RETURN 

This is quite similar to the way BASIC programs may be changed; you 
may type over on the screen, and when you press RETURN, the new line 
replaces the old. The general technique is called screen editing. 

If you have displayed the contents of memory, as in the example above, 
you might tike to change a number of locations to zero. Don't forget to 
strike RETURN so that the change on the screen will take effect in mem- 
ory. Give another . M memory display command to confirm that memory 
has indeed been changed. 

Changing Registers 

We may also change the contents of registers by typing over and pressing 
RETURN. You may take a register display with command . R, and then 
change the contents of PC, AC, XR, and YR. Leave the contents of SR 
and SP unchanged— tricky things could happen unexpectedly if you ex- 
penment with these two. 
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Entering the Program 



We might rewrite our program one last time, marking in the addresses 
that each instruction wit! occupy. You will recall that we have decided to 
put our program into memory starting at address $D33C (part of the 
cassette buffer). 



□3^fl □□ 

Remember that most of the above listing is cosmetic. The business end 
of the program Is the set of two-digit hex numbers shown to the left. At 
the extreme left, we have addresses— that's information, but not the pro- 
gram. At the right, we have the "source code"— our notes on what the 
program means. 

How do we put it in? Easy. We must change memory. So, we go to the 
MLM, and display memory with 

We might have anything in that part of memory, but we'll get a display 
that looks something like 

. :D33C XX xx xx xx xx xx xx xx 
.lUlAA XX XX XX XX XX xx xx xx 

You won't see "xx," of course; there will be some hexadecimal value 
printed for each location. Let's move the cursor back and change this 
display so that it looks like this: 

.:n33C AD flD 03 AE fll 03 flD fll 
.:Q3AA 03 flE flD 03 □□ xx xx xx 

Don't type in the "xx"— just leave whatever was there before. And be 
sure to press RETURN to activate each line; if you move the cursor down 
to get to the next line without pressing RETURN, the memory change 
would not happen. 

Display memory again (.M 0330 034 5) and make sure that the 
program is in place correctly. Check the memory display against the pro- 
gram listing, and be sure you understand how the program is being tran- 
scribed into memory. 



□33C AD flD 03 

□33F AE fll 03 

□342 flD fll 03 

□345 flE flD 03 



LDA $D3flD 
LDX $D3fll 
STA $D3fll 
STX $D3flD 
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If everything looks in order, you're ready to run your first machine language 
program. 

Preparation 

There's one more thing that we need to do. If we want to swap the contents 
of addresses $D3flD and $D3fll, we'd better put something into those 
two locations so that we'll know that the swap has taken place correctly. 

Display memory with .M 03 &Q □3fll and set the resulting display 
so that the values are 

.:D3flD 11 XX XX xx xx xx xx 

Remember to press RETURN. Now we may run our program; we start it 
up with 

.G 0330 

The program runs so quickly that it seems instantaneous (the run time is 
less than one fifty thousandth of a second). The last instruction in our 
program was BRK for break, and that sends us straight to the MLM with 
a display of *B (for break, of course) plus all the registers. 

Nothing seems to have changed- But wait. Look carefully at the register 
display. Can you explain the values you see in the AC and XR registers? 
Can you explain the PC value? 

Now you may display the data values we planned to exchange. Give the 
memory display command . M □3flD Q3fll— have the contents of 
the two locations changed? 

They'd better have changed Because that's what the writing of our pro- 
gram was all about 

Things You Have Learned 

— Computers use binary If we want to work with the inner fabric of the computer, 
we must come to terms with binary values. 

—Hexadecimal notation is for humans, not for computers. It's a less clumsy 
way for people to cope with binary numbers. 

— The 650x microprocessor chip communicates with memory by sending an 
address over its memory bus. 

—The 650x has internal work areas called registers. 

—The program counter tells us the address from which the processor will get 
Its next instruction. 
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— Three registers, called A, X, and Y, are used to hold and manipulate data. 
They may be loaded from memory, and stored into memory. 

— Addresses used in 650x instructions are "flipped " the low byte comes first, 
followed by the high byte. 

—The machine language monitor gives us a new type of communications path 
into the computer. Among other things, it allows us to inspect and change 
memory in hexadecimal. 

Detail: Progrann Execution 

When we say . G □ 3 3 C to start up our progrann, the microprocessor goes 
through the following steps: 

1 It asks for the contents of $ 0330; it receives $AD, which it recognizes as 
the op code "load A . " It realizes that it will need a two-byte address to 
go with this instruction 

2 It asks for the contents of $03 3D, and tnen $D33E. As it receives the 
values of $flD and $03 it gathers them into an "instruction address " 

3 The microprocessor now has the whole instruction The PC has moved along 
to$D33F The 650x now execivfes the instruction It sends address $D3aD 
to the address bus; when it gets the contents (perhaps $11), it delivers this 
to the A register The A register now contains $11. 

4. The 650x IS ready to take on the next instruction, the address $D33F goes 
from the PC out to the address bus; and the program continues. 

Questions and Projects 

Do you know that your connputer has a part of mennory called "screen 
nnennory"? Whatever you put into that part of nnennory appears on the 
screen. You'll find this described in BASIC texts as "screen POKE-ing." 

The screen on the PET/CBM is at $flDDD and up; on the VIC, It's often 
(but not always) at $1EDD and up; on the Connnnodore 64, it's usually at 
$D4DD; and on the PLUS/4, it nnay be found at $DCDD. 

If you write a program to store information in the screen memory address, 
the appropriate characters will appear on the screen. You might like to try 
this. You can even "swap" characters around on the screen, if you wish. 

Two pitfalls may arise. First, you might write a perfect program that places 
information near the top of the screen; then, when the program finishes, 
the screen might scroll, and the results would disappear. Second, the VIC 
and Commodore 64 use color, and you might inadvertently produce white- 
on-white characters; these are hard to see. 
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Here's another question. Suppose I asked you to write a program to move 
the contents of five locations, $D3flD to $D3fl^, in an "end-around" 
fashion, so that the contents of $D3flD moved to $D3fll, $D3fll to 
$D3fl5, and so on, with the contents of $D3fl^ moved to $D3flD. At 
first glance, we seem to have a problem: we don't have five data registers, 
we have only three (A, X, and Y). Can you think of a way of doing the 
job? 



This chapter discusses: 

• Calling machine language subroutines 

• The PRINT subroutine 

• Immediate addressing 

• Calling machine language from BASIC 

• Tiny assembler programs 

• Indexed addressing 

• Simple loops 

• Disassembly 
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Calling Machine Language Subroutines 

In BASIC, a "package" of program statements called a subroutine may 
be brought into action with a GOSUB command. The subroutine ends with 
a RETURN statement, which causes the program to return to the calling 
point, i.e., the statement immediately following GOSUB. 

The same mechanism is available in machine language. A group of in- 
structions may be invoked with a jump subroutine (JSR) command. The 
650x goes to the specified address and performs the instructions given 
there until it encounters a return from subroutine (RTS) command, at 
which time it resumes execution of instructions at the calling point: the 
instruction immediately following JSR. 

For example, if at address $ 0330 I code the instruction JSR $123^, 
the 650x will change its PC to $153^ and start to take instructions from 
that address. Execution will continue until the instruction RTS is encoun- 
tered. At this time, the microprocessor would switch back to the instruction 
following the JSR, which in this case would be address $D33F (the JSR 
instruction is three bytes long). 

As in BASIC, subroutines may be "nested;" that is, one subroutine may 
call another, and that subroutine may call yet another. We will deal with 
subroutine mechanisms in more detail later. For the moment, we'll concern 
ourselves with calling prewritten subroutines. 

Prewritten Subroutines 

A number of useful subroutines are permanently stored in the ROM mem- 
ory of the computer. All Commodore machines have a standard set of 
subroutines that may be called up by your programs. They are always at the 
same addresses, and perform in about the same way regardless of which 
Commodore machine is used: PET, CBM, Commodore 64, PLUS/4, or VIC- 
20. These routines are called the kernel subroutines. Details on them can 
be found in the appropriate Commodore reference manuals, but we'll give 
usage information here. 

The original meaning of the term kernel seems to be lost in legend. It was 
originally an acronym, standing for something like "Keyboard Entry Read, 
Network and Link." Today, it's just the label we apply to the operating 
system that makes screen, keyboard, other input/output and control mech- 
anisms work together. To describe this central control system, we might 
choose to correct the spelling so as to get the English word, "kernel." For 
now, we'll use Commodore's word. 
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The three major kernai subroutines that we will deal with in the next few 
chapters are shown here: 



Address Name 

$FFD? CHROUT 
$FFE^ GETIN 
$FFE1 STOP 



What it does 

Outputs an ASCII character 
Gets an ASCII character 
Checks the RUN/STQP key 



With the first two subroutines, we can input and output data easily. The 
third allows us to honor the RUN/STOP key, to guard against certain types 
of programming error. In this chapter, we'll use CHROUT to print infor- 
mation to the screen. 

C H R U T— The Output Subroutine 

The CHROUT subroutine at address $FFD5 may be used for all types 
of output: to screen, to disk, to cassette tape, or to other devices. It's 
similar to PRINT and PRINT#, except that it sends only one character. 
For the moment, we'll use CHROUT only for sending information to the 
computer screen. 



Subroutine- CHROUT 
Address. $FFD 

Action. Sends a copy of the character in the A register to the 

output channel. The output channel is the computer screen 
unless arrangements have been made to switch it 

The character sent is usually ASCII (or PET ASCII) When sent to the 
screen, all special characters— graphics, color codes, cursor move- 
ments — will be honored in the usual way. 

Registers: All data registers are preserved dunng a CHROUT call. 
Upon return from the subroutine, A, X, and Y will not have changed. 

Status: Status flags may be changed. In the VIC and Commodore 64, 
the C (carry) flag indicates some type of problem with output 



To print a letter X on the screen, we would need to follow these steps: 

1 Bring the ASCII letter X ($5(3) into the A register, 
2. JSR to address $FFD?. 
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Why Not POKE? 



It may seem that there's an easier way to make things appear on the 
screen. We might POKE information directly to screen memory] in ma- 
chine language, we would call this a store rather than a POKE, of course. 
The moment we change something in this memory area, the information 
displayed on the screen will change. Screen memory is generally located 
at the following addresses: 

PET/CBM- $flDDD and up (decimal 3??tfl ) 

Commodore 64: $D^DD and up (decimal lU^A) 

264/364 $DCDD and up (decimal 3D??) 

VlC-20. $!£□□ and up (decimal ?tflD) 

The screen memory of the VIC-20 in particular may move around a good 
deal, depending on how much additional RAM memory has been fitted. 

Occasionally, screen POKEs are the best way to do the job. But most of 
the time we'll use the CHROUT, $FFD5 subroutine. Here are some of 
the reasons why: 

• As with PRINT, we won't need to worry about where to place the next 
character, it will be positioned automatically at the cursor point. 

• If the screen is filled, scrolling will take place automatically. 

• Screen memory needs special characters. For example, the character X has 
a standard ASCII code of $5fl, but to POKE it to the screen we'd need to 
use the code $lfl. The CHROUT subroutine uses $5fl. ' 

• Screen memory may move around, depending on the system and the pro- 
gram. The POKE address would need to change; but CHROUT keeps 
working 

• Special control characters are honored: $DD for RETURN, to start a new 
line; cursor movements; color changes. We can even clear the screen by 

" loading the screen-clear character ($R3) and calling $FFDE. 

• "To POKE the screen of the VIC or Commodore 64, the corresponding color 

nybble memory must also be POKEd (see the appropriate memory map in 
Appendix B). With ihe subroutine ai $FFDE, color is set automatically. 



A Print Project 



Let's write some code to print the letter H on the screen. Once again, we'll 
use address $ 033 0, the cassette buffer, to hold our program. Reminder: 
be sure to have your monitor loaded and ready before you start this project. 
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First, the plan; we lay out the instructions 
LDA #$^fl 

We're using a new symbol (#) to signal a special type of information. It 
goes by a variety of names: pounds sign, sharp, hash mark, or numbers 
sign. A more formal name for the symbol is octothorpe, meaning "eight 
points." Whatever you call it, the symbol means "the following information 
is not an address, it's a value." In other words, we don't want the computer 
to go to address $^fl, we want it to load the A register with the value 
$^fl, which represents the ASCII letter H. This type of information access 
is called immediate addressing. In other words, take the information im- 
mediately, don't go to memory for it. 

JSR $FFD2 

The previous instruction brought the letter H into the A register; this one 
prints it to the screen. Now all we need to do is quit. BRK takes us to the 
machine language monitor. 

Monitor Extensions 

We could repeat the steps of the previous chapter: hand-assembling the 
source code into machine language, and then placing it into memory. We 
would need to know the instruction codes, and then do a careful translation. 
But there's an easier way. 

Most machine language monitors contain extra commands to help us do 
this type of mechanical translation. We'll use the assembler feature of 
these monitors. 

Most monitors contain the assemble ( . A) command. The notable excep- 
tion IS the built-in monitors within the PET/CBM; these, however, can be 
extended by loading in a "monitor extension" program such as Supermon. 
The Commodore PLUS/4 series contains an extended monrtor, which 
includes the . A command. 

These assemblers are often called nonsymbolic assemblers. This means 
that whenever an address is needed, you must furnish that exact address. 
You cannot type in a name such as CH ROUT and expect the tiny assem- 
bler to know what address that represents; instead, you must type $FFD5. 

Load your monitor or monitor extension. Do any setup that may be needed. 
Then type the following monitor command: 



.A 0330 LDA #$^fl 
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We are asking the computer to assemble ( . A) at address $D33C (note 
we don't use the $ here) the command LD A, Load A, the immediate value 
of $^fl, which represents the ASCII letter H. When you press RETURN 
after entering this line, the computer may do either of two things: 

1. It may do notning except print a question mark somewhere on the line. The 
question mark indicates an error in your coding If the question mark appears 
directly after the letter A, your monitor does not understand the . A assemble 
instruction; get another monitor or properly set up the one you have. 

2. Or, It will correctly translate your instruction, and put the object code into 
memory starting at the address specified. In this case, that would happen 
to be $AR at address $D33C and $^fl at address $D33D. It would then 
help you by printing part of the next expected instruction The computer 
expects that you will type a line starting with 

. A □33E 

It places the first part of this line on the screen to save you typing. The 
screen should now look like this: 

.A 0330 LDA #$^fl 
.A □33E 

You may now complete the instruction by typing in JSR $FFD2 and 
pressing RETURN. Again, the connputer will anticipate your next line by 
printing .A 03^1, which allows you to type in the final command, BRK. 
The screen now looks like this: 

.A 0330 LDA #$^fl 
.A □33E JSR $FFD5 
.A 03^1 BRK 
.A 03AE 

The computer is still waiting for another instruction. We have no more 
instructions, so we press RETURN to signal that we're finished. 

At this point, our program is stored in memory. The instructions have been 
assembled directly into place, and the object code is hopefully ready to 

go 

Note that this saves us the trouble of remembering — or looking up — the 
op codes for each instruction. And we don't need to keep track of how 
long each instruction should be; the assembler does it for us. 

If you like, you can display memory and look at the object program with 
the.M 0330 □3^1. You'll see the bytes of your program in memory: 

. :D33C AR ^fl EQ D5 FF □□ XX XX 
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The first six bytes are your program. Trie last two bytes don't matter: they 
were whatever was in that part of memory before. We don't care what is 
there, since the program will stop when it reaches the BRK ($□□) at 
address $ □ 3 ^ 1 ; it won't be concerned with the contents of memory at 
$□3^5 or $03^3. 

Checking: The Disassembler 

When we changed our source code into object code, we called this process 
of translation assembly, and we called a program that did the job an 
assembler. 

Now we've written a program and it's safely stored in memory. We have 
inspected memory and have seen the bytes there; but they are hard to 
read. It would be convenient if we could perform an inverse assembly, 
that is, take the contents of memory and translate it into source code. The 
monitor has this capability, called a disassembler. 

If we ask the computer to disassemble the code starting at $ D 3 3 C , it will 
examine the code there and establish that the contents ($ A'^l) correspond 
to an LDA immediate command. It will then print for our information LDA 
fl, which is much more readable than the original two bytes, ^ fl. 

Give the command .D 0330 and press RETURN. D stands for disas- 
semble, of course, and the address must follow. 

The computer will now show a full screen of code. On the left is the address 
followed by the bytes making up the instruction. On the right is the re- 
constructed source code. The screen shows much more memory than our 
program needs. Again, we ignore all lines beyond address $03^1, which 
is the last instruction of our program. Anything following is "junk" left in 
memory that the program does not use. 

An interesting feature of most disassembly listings is that the cursor is left 
flashing on the last line of the disassembly rather than on the line below. 
When you have a large program, this allows you to type the letter D 
followed by RETURN and the next part of your program will immediately 
be displayed. On the other hand, if you don't want to disassemble more 
code, press the cursor down key and move to a "clean" line before typing 
your next instruction. 

A disassembly is a good way to check for errors. If you find an error in 
the listing, you may correct that line by re-assembling it, using the . A 
command once again. Minor errors may be corrected directly on the left- 
hand side of the disassembly listing. In other words, suppose that you had 
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incorrectly coded LDA #$5fi during the assembly phase; when you per- 
form the disassembly, this line will show as 

. , 0330 5fl LDA #$5fl 

You recognize that the 5fi should be ^ fi; you may move the cursor up — 
use cursor home if you wish — and type over the value on the left-hand 
side. In this case, you place the cursor over the 5, type A to change the 
display to A fl, and press RETURN. You will see from the display that the 
problem has been fixed. 



If necessary, move the cursor down to an empty line. Type the command 
. G 0330 and the program will run. Again, it doesn't take long; the break 
back to the MLM seems instantaneous. Where's the letter H that we were 
supposed to print? It's hard to see, but it's there. Look at your . G 03 30 
command and you'll see it. 

Project for enthusiasts: Can you add to the program and print HI? The 
ASCII code for the letter I is Can you add again and print HI on 
a separate line? The ASCII code for a RETURN is $DD. Remember that 
you can find all ASCII codes in Appendix D; look in the column marked 
ASCII. 



So far we have started up our programs with a . G (go) command from 
the MLM, and we have terminated our programs with a BRK command 
that returns us to the monitor. That's not a convenient way to run a program; 
most users would prefer to say RUN out of BASIC and have the computer 
do everything. 

We can link to a machine language program from BASIC and when the 
program is finished, it can return to BASIC and allow the BASIC program 
to continue to run. The commands we need are 

(BASIC) SYS— Go to a machine language subroutine at the stated address, 
(Machine language) RTS— Return to whoever called this subroutine 

Let's change our machine language program first. We must change the 
BRK at the end to RTS (return from subroutine) so that when the program 
is finished it will return to BASIC If you like, you may change it directly 
on the disassembly listing: disassemble and then type over the DD byte 



Running the Program 
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that represents BRK with a value of bD. Press RETURN and you'll see 
that the instruction has now changed to RTS. Alternatively, you may re- 
assemble with 

.A 0330 LDA #$A& 
.A □33E JSR $FFD2 
.A 03^1 RTS 

Now return to BASIC (using the . X command). The computer will say 
READY; you may now call your program with a SYS command. 

Address $D33Cisfl2flin decimal. Thus, we type SYS fl 2 fl . When we 
press RETURN, the letter H will be printed. 

We're not ifintshed. Any machine language subroutine may be called from 
a BASIC program. Type NEW, which clears out the BASIC work area; our 
machine language program is left untouched, since NEW is a BASIC com- 
mand. Now enter the following program: 

lan FOR J = l TO-ID 

iiD SYS as a 

lED NEXT J 

How many times will our program ata2a($D33C)be called? How many 
times will the letter H be pnnted? Will they be on the same line or separate 
lines'? Type RUN and see. 

Project for enthusiasts: Again, change the machine language program 
to say HI. Use your imagination. What else would you like the computer 
to say? Would you like to use colors or reverse font? 

We've achieved an important new plateau: BASIC and machine language 
working together. It's easier on the user, who doesn't have to learn spe- 
cialized monitor commands. It's easier on the programmer, too, since 
things that are easy to do in BASIC can be written in that language; things 
that are clumsy or slow in BASIC can be written in machine language. We 
can get the best of both worlds. 

Let's distinguish our three different types of subroutine calls: 
GOSUB— calls a BASIC subroutine from a BASIC program. 
SYS — calls a machine language subroutine from a BASIC program 
JSR — calls a machine language subroutine from machine language. 

Loops 

We know how to send characters to the screen, one at a time But long 
messages, such as THE QUICK BROWN CAT . . might lead to te- 
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dious coding if we had to write an instruction for each letter to be sent. 
We need to set up a program loop to repeat the printing activity. 

Let's write a program to print the word HELLO followed by a RETURN. 

We must store the word HELLO somewhere in memory. It doesn't matter 
where, provided it doesn't conflict with anything else. I'll arbitrarily choose 
address $D3^R to $D3^F. We'll put it there in a moment. Remember 
that the characters that make up the word HELLO (plus the RETURN) 
are not program instructions; they are simple data. We must put them in 
place with a memory change — we must not try to assemble them. 

We will need to count the characters as we send them. We wish to send 
six characters, so a count of six is our limit. Let's use the X register to 
keep track of the count. First, we must set X to zero: 

.A 0330 LDX #$□□ 

Note that we use the # symbol to denote an immediate value: we want 
to load X with the value zero, not something from address □. Now, we'll 
do something new. I want to take a character to be printed from address 
$□3^ A. But wait, that's only the first time around. When we come back 
to this point in the loop, I want to take a character from $D3^B, and then 
from $D3^C, and so on. 

How can we do this? It seems that we must write one address into the 
LDR instruction, and that address can't change. But there is a way. 

We can ask the computer to take the address we supply, and add the 
contents of X or Y to this address before we use it. The computed address 
IS called an effective address. 

Let's look at our position. The first time around the loop, X is counting the 
characters and has a value of zero. If we specify our address as □ 3 ^ A + X, 
the effective address will be 03^ A. That's where we will have stored the 
letter H. 

When we come back around the loop— we haven't written that part yet— 
X should now equal one. An address of □ 3 ^ A + X would give an effective 
address of 03^8; the computer would go there and get the letter E. As 
we go around the loop, the letters, L, L, 0, and RETURN will be brought 
in as needed. 

As we enter the LDA instruction, we don't type the plus sign. Instead, we 
signal indexing with a comma: LDA $D3^A/X. We may use either X or 
Y for indexing: they are sometimes called index registers. In this case, of 
course, we use X. So we code 
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.A D33E LDR $D3^R,X 
.A 03^1 JSR $FFD2 

The first time, the computer loads the contents of address $D3^A (the 
letter H of HELLO) and prints it. When the loop comes back here, with 
X equal to one, this instruction will load the contents of $ 03^8 and print 
the letter E. 

The X register counts the number of letters printed, so we must add one 
to the contents of X. There's a special command that will add one to the 
contents of X: I NX, for increment X. A similar code, I NY, allows Y to 
be incremented; and DEX (decrement X) and DEY (decrement Y) allow 
X or Y to be decremented, or reduced, by one. At the moment, I NX is 
the one we need for counting: 

.AD3AA INX 

Now we can test X to see if it is equal to six yet. The first time around, it 
won't be since X started at zero and was incremented to a value of 1. If 
X IS not equal to six, we'll go bacK to $D33E and print another letter. 
Here's how we code it: 

.A 03^5 CPX #$Db 
.A 03^7 BNE $D33E 

CPX stands for compare X; note that we are testing for an immediate 
value of six, so we use the # symbol. BNE means branch not equal; if X 
is not equal to six, back we go to address $D33E. 

A little careful thought will reveal that the program will go back five times 
for a total of six times around the loop. It's exactly what we want. 

Let's show the whole code, completing it with RTS: 

.A 0330 LDX #$□□ 

.A □33E LDA $D3^A,X 

.A 03^1 JSR $FFD2 

,AD3^^ INX 

.A D3AS CPX #$Db 

.A 03^7 BNE $D33E 

.A 03^9 RTS 

We may now put the characters for HELLO into memory. These are data, 
not instructions, so we must not try to assemble them. Instead, we change 
memory in the usual way, by displaying and then typing over. We give 
the command . M □3<A □3^F, and type over the display to show 

. :D3^A ^fl ^5 ^F DD XX XX 
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By a lucky coincidence, this data fits exactly behind our program. 

Everything should be ready now Disassemble the program at $D33C 
and checl< it. You may note that the data at $034 R doesn't disassemble 
too well, but that's to be expected; these bytes are not instructions and 
cannot be decoded. 

When all looks well, return to BASIC (with . X) and try SYS flEfl. The 
computer should say HELLO. 

Once again, set up a BASIC loop program: 

100 FOR J = 1T0 3 
110 SYS flE a 
120 NEXT J 

A Comment on SAVE 

If you wished to save the program to cassette tape, you'd have a problem 
on the ViC or Commodore 64. The machine language program is m the 
cassette buffer; a save-to-tape command would cause the contents of that 
buffer to be destroyed before the program could be written to tape. Even 
disk commands would not be completely safe: 4.0 BASIC disk commands 
use the cassette buffer area as a work area; using these commands would 
probably destroy our machine language program. 

But saving the program is not the mam problem. A correctly saved program 
can give trouble when you try to bring it back and run it safely. The difficulty 
IS related to BASIC pointers, especially the start-of- variables pointer. The 
problem, and how to solve it, will be discussed in some detail in Chapter 
6 

A Stopgap SAVE 

We can preserve short programs by making them part of DATA state- 
ments. The procedure is not difficult if screen editing is used intelligently. 

We note that the program extends from $D33Cto$D3^F, including the 
message (HELLO) at the end. The decimal equivalents to these ad- 
dresses are flSfl to Enter the following BASIC line: 

FOR J = fl2fl TO fl^7: PRINT PEEK( J) ; :NEXT J 

Study the above line. You will see that it asks BASIC to go through the 
part of memory containing your machine language program, and display 
the contents (in decimal notation, of course). You'll see a result that looks 
something like this: 
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it,e □ iflR 7< 3 3E eiD ess eae ee< t, eofl e<5 Rt, 

75 t,R 7t, 7t, 7R 13 

These are indeed the bytes that make up your program. With a little study, 
you could reconstruct the IbS-D combination to be LDX #$□□, or the 
7 2-bR-7 b-7 b-7R at the end to be the word HELLO in ASCII. It looks 
different when it's in decimal, but it's still the same numbers. 

You may try a little skill and artistry, using screen editing to perform the 
next activity, or you may just retype the numbers into data lines a shown. 
Either way, arrange the numbers as follows: 

SD DATA IbS, 0,139,7^, 3, 32, 21D,E55, 232, E2^,b 
kD DATA 2Dfl,2^5,Rb,7E,bR,7b,7b,7R,13 

We now have a copy of our program, exactly the way it appears in memory, 
but stored within DATA statements. The DATA statements are part of a 
normal BASIC program, of course, and will SAVE and LOAD with no 
trouble at all. 

We can now reconstruct our machine language program, placing it back 
into memory, with a simple BASIC POKE program: 

flD FOR J = fl2fl TO fl^7: READ X:POKE J, X: NEXT J 

Now our program is safe and sound — it handles like BASIC, but it will do 
a machine language task for us as desired. Let's display the entire BASIC 
program 

50 DATA it,e,D,iflR,7<,3,3e,eiD,e55,e3e,ee4,t, 

bO DATA e0fl,e4 5,Rt,,7e,t,R,7t,,7t,,7R,13 

flO FOR J =626 TO fl47 : READ X : POKE J,X:NEXT J 

100 FOR J= 1 TO 3 

110 SYS 626 

leO NEXT J 

This method of saving a machine language program is clean and trouble 
free, but it becomes awkward where long programs are involved. More 
advanced methods will be discussed in Chapter 6. 

Things You Have Learned 

— Subroutines can be called from machine language using the JSR command. 
There are several useful kernal subroutines permanently available. 

— A BASIC program may call a machine language program as a subroutine: 
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the BASIC command is SYS The machine language subroutine returns to 
the calling point with an RTS (return from subroutine) instruction 

—The CHROUT subroutine at address $FFDE allows output of a character, 
usually to the screen In addition to printable characters, special cursor- and 
color-control characters may be sent. 

—Most machine language monitors have a small assembler to help program 
preparation, and a disassembler to assist in program checking. 

—Immediate mode is signaled by use of the # symbol. The computer is asked 
to take the value given, instead of going to a specified address for its data. 

—X and Y are called index registers. We may add the contents of X or Y to a 
specified address, to create an effective address that changes as the program 
runs. This addition is called indexing 

—X and Y also have special instructions that increase or decrease the selected 
register by one These are called increment and decrement instructions, and 
are coded INX, INY, DEX, and DEY 

Questions and Projects 

Look through the table of ASCII characters in Appendix D. Note that hex 
R3 is "clear screen." Wnte a progrann to dear the screen and print "HO 
HOI 

You may have noticed that in our example, we had register X counting 
up from zero to the desired value. What would happen if you started X at 
5 and counted down? Try it if you like. 

Remember that you can also include cursor movements, color codes (if 
your machine has color), and other special ASCII characters. Could you 
lay out the coding to draw a box? (Try it in BASIC first). Draw a box with 
the word HELLO inside it. 
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Flags, Logic, 
and Input 

This chapter discusses: 

• Flags that hold status information 

• Testable flags Z, C, N, and V 

• Signed numbers 

• The status register 

• First concepts of interrupt 

• Logical operators OR, AND, EOR 

• The GETIN subroutine for input 

• The STOP subroutine 
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Flags 

Near the end of Chapter 2, we coded a program that had the seemingly 
natural sequence 

CPX #$Dt 
BNE $ 

It made sense: compare X for a value of t, and if not equal, branch back. 
Yet it implies something extraordinary; the two instructions are somehow 
linked. 

Let's flash forward for a moment. Even when you have a machine language 
program running, the computer "freezes" sixty times a second. The com- 
puter undertakes a special activity, called interrupt processing. It stops 
whatever it was doing, and switches to a new set of programs that do 
several tasks: flashing the cursor, checking the keyboard, keeping the 
clock up to date, and checking to see whether the cassette motor needs 
power. When it's finished, it "unfreezes" the main program and lets it 
continue where it left off. 

This interrupt might take place between the two instructions shown above, 
that is, after the CPX and before the BNE. Hundreds of interrupt instruc- 
tions might be executed between the two, yet nothing is harmed. The two 
instructions work together perfectly to achieve the desired effect. How can 
the computer do this? 

The two instructions are linked by means of a flag— a part of the 650x 
that records that something has happened. The CPX instruction tests X 
and turns a special flag on or off to signal how the comparison turned out: 
equal or unequal. The BNE instruction tests that flag, if it's on (meaning 
equal), no branch will take place and the program will continue with the 
next instruction; if it's off (meaning not equal), a branch will take place. 

In other words, some instructions leave a "trail" of status information; other 
instructions can check this information. The status information is called 
"flags." There are four flags that may be tested: Z, C, N, and V. They are 
discussed below. 

Z Flag 

The Z (zero) flag is probably misnamed, and should have been called the 
E flag (for "equals"). After any comparison (CPX to compare X, CPY to 
compare Y, or CMP to compare A), the Z flag will be set to "on" if the 
compared values are equal; otherwise it will be reset to "off." 
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Sometimes the Z flag checks for equal to zero, hence its name, Z for 
zero. This happens for every activity that may change one of the three 
data registers. Thus, any load command will affect the Z flag status. The 
same is true of increment and decrement instructions, which obviously 
change registers. And later, when we meet other operations such as ad- 
dition and subtraction, they too will affect the Z flag. 

There are many instructions that don't affect the Z flag (or any flag, for 
that matter). Store instructions (STA, STX, STY), never change a flag. 
Branch instructions test flags but don't change them. 

An example will help illustrate the way that some instructions change flags 
and others do not. Examine the following coding: 

LDA #$E3 (Load E3 to A) 

LDX #$□□ (Load zero to X) 

STA $1E3< (store E3 to address $1E3<) 

BEQ $ . . • • 

Will the branch (BEQ) be taken, or will the 650x continue with the next 
instruction? Let's analyze the Z flag's activity step by step. The first in- 
struction (LDA #$E3) resets the Z flag, since E3 is not equal to zero. 
The second instruction (LDX #$□□) sets the Z flag because of the zero 
value. The third instruction (STA $1E3A) does not affect the Z flag; m 
fact, store instructions do not affect any flags Thus, by the time we reach 
the BEQ instruction, the Z flag is set "on" and the branch will be taken. 

650x reference manuals show the specific flags that are affected by each 
instruction. In case of doubt, they are easy to check. 

The Z flag is quite busy— it clicks on and off very often since many in- 
structions affect it. It's an important flag. 

If the Z flag is set "on," the BEQ (branch equals) instruction will branch 
to the specified address; otherwise it will be ignored and the next instruction 
in sequence will be executed, if the Z flag is reset "off," the BNE (branch 
not equals) instruction will branch. 

We can see in more detail how our program from Chapter 2 worked. 
CPX #$Dt causes the Z flag to be set "on" if X contains the value t; 
otherwise it causes the Z flag to be reset "off." BNE tests this flag, and 
branches back to the loop only if the Z flag is off— in other words, only if 
the contents of X is not equal to six. 
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C Flag 

The C (carry) flag is probably misnamed, too. It should have been called 
the GE (greater/equal) flag, since after a comparison (CPX, CPY, or CMP), 
the C flag is set "on" if the register (X, Y, or A) is greater than or equal 
to the value compared If the register concerned is smaller, the C flag will 
be reset "off." 

The C flag is not as busy as the Z flag. The C flag is affected only by 
comparison instructions and by arithmetic activities (add, subtract, and a 
type of multiplication and division called rotate or shift). When used in 
antnmetic, the C flag is properly named, since it acts as a "carry" bit 
between various columns as they are calculated. For example, an LDA 
instruction always affects the Z flag since a register is being changed, but 
never affects the C flag since no arithmetic or comparison is being per- 
formed. 

If the C flag is set "on," the BCS (branch carry set) instruction will branch 
to the specified address; otherwise it will be ignored and the next instruction 
in sequence will be executed. If the C flag is reset ''off," the BCC (branch 
carry clear) instruction will branch. 

The C flag may be directly set or reset by means of the instructions SEC 
(set carry) and CLC (clear carry). We will use these instructions when we 
begin to deal with addition and subtraction. 

If you examine the last program of Chapter 2, you will see that the BNE 
instruction could be replaced by BCC. Instead of "branch back if not equal 
to 6," we could code "branch back if less than 6." The operation would 
be the same in either case. 

N Flag 

The N (negative) flag is also probably misnamed. It should have been 
called the HB (high bit) flag, since numbers are positive or negative only 
if they are used in a certain way. The N flag is set to indicate that a register 
has been given a value whose high bit is set. 

The N flag is as busy as the Z flag; it changes with every instruction that 
affects a register. The N flag is affected by comparisons, but in this case 
its condition is not usually meaningful to the programmer. 

To sort out the operation of the N flag, it's important to become familiar 
with hexadecimal-to-binary conversion. For example, will LDA #$ set 
the N flag? Rewrite it into binary: $t5 equals ^□IIDDIDI. We can see 
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that the high bit is not set, meaning that the N flag will be off after loading 
this value. As another example, suppose we LDX #$DA. Hex DA is 
IIDIIDID binary. We see that the high bit is on and thus the N flag Is 
set. 

If the N flag is set "on," the BMI (branch minus) instruction will branch 
to the specified address; otherwise it will be ignored and the next instruction 
in sequence will be executed. If the N flag Is reset "off," the BPL (branch 
plus) instruction will branch 

A Brief Diversion: Signed Numbers 

How can a location — which is usually thought to contain a decimal value 
from □ to 255 — contain a negative number? It's up to the programmer 
to decide whether a memory value Is unsigned, having a value range from 
□ to 255, or Signed, having a value range from - lEflto +1E7. There 
are still a total of 25 1 possibilities. The computer's memory simply holds 
bits, while the programmer decides now the bits are to be used In a specific 
case 

Mathematically, It's described this way: signed numbers, if desired, are 
held in two's-complement form. We can hold - 1 as hex FF, and - E 
as hex FE. all the way down to - lEfl as hex flD. You may have noticed 
that in all the examples, the high bit is set for these negative numbers. 

We may need more intuitive help, however. If the computer loads the 
decimal value EDO into the A register with LD A #$Cfl, the N flag will be 
set and will seemingly indicate that EDD is a negative number. It may be 
more comfortable to simply think of EDD as a number with the high bit 
set. But m a sense, EDD could be a negative number if we wanted it to 
be. Let's examine the situation by means of examples. 

If I were asked to count down in hexadecimal from ID, I'd start out $ ID, 
$DF, $DE,and $DD, continuing down to $DE, $Dl,and $DD. If I needed 
to keep going, I'd continue past $DD with $FF; in this case, hexFF would 
clearly represent negative one. Continuing, FE, FD, and FC would rep- 
resent - E, - 3, and - A. And the high bit is set on all these "negative" 
numbers. 

Let's discuss a decimal analogy. Suppose you have a cassette recorder 
with a counter device attached, and the counter reads 0025. If you rewind 
the unit a distance of 30 units, you would not be surprised to see a value 
of 9995 on the counter and would understand that It meant a position of 
-5. If you had a car with 1 ,500 miles on the odometer, and "rolled back" 
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the mileage by 1,501 miles, you'd see a reading of 99999, which would 
mean - 1 . (The author does not know this from personal experience, but 
is assured by many machine language students that it is so.) In these 
cases, based on the decimal system, the negative numbers are called 
"ten's complement." 

V Flag 

As with the other flags, the V (overflow) flag is probably misnamed. It 
should have been called the SAO (signed arithmetic overflow) flag, since 
it is affected only by addition and subtraction commands, and is meaningful 
only if the numbers concerned are considered to be signed. 

The V flag is used only occasionally in typical 650x coding. Many machine 
language programs don't use signed numbers at all. The most typical use 
of the V flag is in conjunction with a rather specialized command, BIT 
(bit test). For this instruction, the V flag signals the condition of bit t of 
the memory location being tested. In this case, V and N work in a similar 
way: N reflects the high bit, bit 7, and V represents the "next bit down," 
bit t. The BIT command is used primanly for testing input/output ports 
on I A (interface adaptor) chips. 

If the V flag is set "on," the BVS (branch overflow set) instruction will 
branch to the specified address; otherwise it will be ignored and the next 
instruction in sequence will be executed. If the V flag is reset "off," the 
BVC (branch overflow clear) instruction will branch. 

The V flag may be directly reset by means of the CLV (clear overflow) 
instruction. Oddly, there is no equivalent instruction to set the flag. 

One special feature of the V flag: on some 650x chips, the V flag can be 
set by hardware. There is a pin on the chip that can be used so that an 
external logic signal win trigger the V flag. 

A Brief Diversion: Overflow 

The term overflow means "the result is too big to fit." For example, if I 
add EDO to 5 □□, the total is but this won't fit in a single byte. 

If we have only a single byte to store the result, we say that the addition 
has encountered overflow, and we can't produce a meaningful answer. 

If we are using unsigned numbers, the C flag tells us about overflow. If 
we are using signed numbers, V tells the story. We'll take this up again 
in the next chapter. 
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Flag Summary 



A brief table may help review the four testable flags. 



Flag Brief Activity 
Name Meaning Level 



Branch Taken If: 
Set Not-Set 



Z Zero, equal Busy 

C Carry, greater/equal Quiet 

N Negative, high-bit Busy 

V Signed arithmetic overflow Quiet 



BEQ BNE 

BCS BCC 

BMI BPL 

BVS BVC 



The Status Register 



The preceding flags — and three others — may be viewed within the status 
register (SR). You may recall that the machine language monitor gives 
an SR display. If you know how to read it, you can see the condition of 
all flags. 

Each flag is a bit within the status register. Again, it's useful to be able to 
easily translate the hexadecimal display, so as to view the individual flags. 
Here's a chart of the flags within the status register: 

NV-BDIZC 
Taking the bits one at a time, starting at the high bit: 

N— the N flag, as above 
V — the V flag, as above. 

Bit 5 — unused You'll often find that this bit is "on." 

B— "Break" indicator. When an interrupt occurs, this signals whether or not the 
interrupt was caused by a BR K instruction. 

D — Decimal mode indicator. This changes the manner in which the add and 
subtract instructions operate. In Commodore machines, this flag will always be 
off. Don't turn it on unless you know exactly what you're doing. This flag may 
be turned on with the SED (set decimal) instruction, and turned off with the 
CLD (clear decimal) instruction. 

I — Interrupt disable. More exactly, this bit disables the IRQ (interrupt request) 
pin activity. More on this control bit much later. This flag may be turned on with 
the SEI (set interrupt disable) instruction, and turned off with the CLI (clear 
interrupt disable) instruction 

Z— the Z flag, as above. 

C — the C flag, as above. 
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Flags B, D, and I are not testable flags in that there are no branch instructions 
that test them directly D, the decimal mode flag, ana I, ihe interrupt lockout 
flag, may oe considered "control" flags. Instead of reporting conditions found 
as the program runs, they control how the program operates. 

When we see a value displayed in the SR, or status register, we may 
examine it to determine the condition of the flags, especially the testable 
flags Z, C, N, and V. For example, if we see an SR value of $B1, we 
translate to binary ^IDllDDDl and know that the N flag is on, the V 
flag is off, the Z flag is off, and the C flag is on. 

You may change these flags by typing over the displayed value in the 
machine language monitor Be careful you don't accidentally set the D or 
I flags 

A Note on Comparison 

If we wish to compare two bytes with each other, we must perform a 
comparison. One value must be in a register (A, X, or Y); the other must 
either be stored in memory, or must be an immediate value we use in the 
instruction. 

We will use the appropriate compare instruction depending on the register 
involved; CMP for the A register, CPX for the X register, and CPY for the 
Y register Following the comparison, we may use any of the following 
branch tests: 

BE Q— branches if the two bytes are equal 
BNE — branches if the two bytes are not equal 

BCS — branches if the value in the register is greater than or equal to the other 
value 

BCC — branches if the value in the register is less than the other value. 

We can use more than one branch instruction after a comparison. Suppose 
our program wanted to test the Y register for a value equal to or less than 
5. We might code 

CPY #$D5 

BEQ . . somewhere 

BCC . . somewhere 

We can see that our code will branch if the value is equal to 5 (using the 
BEQ) or less than 5 (using the BCC); otherwise it will continue without 
branching. In this case, we could make the coding more efficient by chang- 
ing it to read 
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CPY #$Dt 

BCC . . somewhere 

A little common sense will tell us that testing a number to see if it is less 
than t is the same as testing it to see if it is less than or equal to 5. 
Common sense is a valuable programming tool. 

Instructions: A Review 

We have looked at the three data registers— A, X, and Y— and have seen 
three types of operation we can perform with them: 

Load: LDA, LDX, LDY 

Store: STA, STX, STY 

Compare: CMP, CPX, CPY 

Up to this point, the registers have identical functions, and we can use 
any of them for any of these functions But new instructions are creeping 
in that give a different personality to each of the three. 

We have noted that INX, INY, DEX, and DEY for increment and dec- 
rement are restricted to X and Y only; and we've also mentioned that X 
and Y can be used for indexing. Soon, we'll start to examine some of the 
functions of the A register, which is often called the accumulator because 
of its ability to do arithmetic. 

We have seen JSR, which allows us to call a subroutine of prewritten 
instructions. We've used RTS, which says, "Go back to the calling point," 
even if the calling point is a BASIC program. And we've almost abandoned 
the BRK instruction, which stops the program and goes to the machine 
language monitor BRK will be useful in checking out programs. Specifi- 
cally, we can stop a program at any time by inserting a BRK instruction, 
allowing us to see whether the program is behaving correctly and whether 
it has done the things we planned. 

There are eight branch instructions. They have already been discussed, 
but there is one additional piece of information that is important to keep 
in mind. All branches are good only for short hops of up to a hundred 
memory locations or so. So long as we write short programs, that won't 
be a limitation; but we'll look at this more closely in Chapter 5. 

Logical Operators 

Three instructions perform what are called logical operations. They are: 
AND (Logical AND); ORA (Logical OR); and EOR (Exclusive OR). These 
instructions work on the A register only. 
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Mathematicians describe these operations as commutative. For example, 
a value of $3A "AND" $57 gives exactly the same result as $57 
"AND" $3 A. The order doesn't matter. But we often use these func- 
tions — and think of them — in a particular order. It's the same as with 
addition, where we think of a "total" to which is added an "amount" to 
make a "new total." With the logical operators we often think of a "value," 
which we manipulate with a "mask" to make a "modified value." 

Logical operators work in such a way that each bit within a byte is treated 
independently of all the other bits. This makes these instructions ideal for 
extracting bits, or manipulating certain bits while leaving others alone. 

We'll look at formal definitions, but the following intuitive concepts are 
useful to programmers: 

AND— turns bits off. 
OR A — turns bits on 
E OR— flips bits over. 

M J)— Logical AND to A 

For each bit in the A register, AND performs the following action: 

Original A Bit Mask Resulting A Bit 



10 
□ 1 

111 

Examine the upper half of this table. When the mask is zero, the original 
bit in A is changed to zero. Examine the lower half. When the mask is 
one, the original bit is left unchanged. Hence, AND can selectively turn 
bits off. 

Example: Turn off bits 5, and t in the following value: $C7 

Original value: llOODlll 

Mask. AND 10001111 (hex BF) 



Result lODOOlll 

XXX 

Note that the bits marked have been forced to "off," while all other bits 
remain unchanged. 
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OR A— Logical OR to A 

For each bit in the A register, OR A performs the following action: 

O riginal A Bit Mask Resulting A Bit 



10 1 

oil 
111 



Examine the upper half of this table. When the mask is zero, the original 
bit in A is left unchanged. Examine the lower half. When the mask is one, 
the original bit is forced to "on." Hence, OR A can selectively turn bits on. 

Example: Turn on bits 5, and t in the following value: $C7 

Original value: 11000111 

Mask. EOR 01110000 (hex 70) 



Result 11110111 

XXX 

Note that the bits marked have been forced to "on," while all other bits 
remain unchanged. 

EOR— Exclusive OR to A 

For each bit in the A register, EOR performs the following action: 

Original A Bit Mask Resulting A Bit 



10 1 

oil 

110 

Examine the upper half of this table. When the mask is zero, the original 
bit in A is left unchanged. Examine the lower half. When the mask is one, 
the original bit is inverted; zero becomes one and one becomes zero. 
Hence, EOR can selectively flip bits over. 

Example: Invert bits 5, and b in the following value: $C7 
Original value: 11000111 
Mask: EOR 01110000 (hex 70) 



Result 



10110111 
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Note that the bits marked have been flipped to the opposite value, while 
all other bits remain unchanged. 

Why Logical Operations? 

We use these three commands— AND, ORA, and EOR— to change or 
control individual bits within a byte of information. The commands are 
unusual in that each bit may be manipulated independently of the others. 

We don't seem to be working with numbers when we use these commands. 
Rather, we're working with each individual bit, turning it on or off as we 
wish. 

Wily would we turn individual bits on or off? There are several possible 
reasons. For example, we might wish to control external devices through 
the I A's (interface adaptors). Within the lA's input and output ports each 
of the eight bits might control a different signal; we might want to switch 
one control line on or off without affecting other lines. 

When we're looking at input from an I A port, we often read several input 
lines mixed together within a byte. If we want to test a specific bit to see 
if it is on or off, we might mask out all other bits with the AND instruction 
(changing unwanted bits to zero); if the remaining bit is zero, the whole 
byte will now be zero and tne Z flag will be set. 

Why would we want to flip bits over? Many "oscillating" effects — screen 
flashing or musical notes — can be accomplished this way. 

Finally, the logical operators can be useful in code translation. For ex- 
ample, here are the values for ASCII 5 and binary 5. 

ASCII ^OOllDlOl 
Binary ^□□□00101 

We must use the ASCII value for input or output. We must use the binary 
value for arithmetic, particularly addition and subtraction. How could we 
get from one to the other? By taking bits out (AND) or putting bits in (ORA). 
Alternatively, we could use addition or subtraction; the logical operators, 
however, are simplier. 

Input: The GE T I N Subroutine 

We have seen how we can use CHROUT at $FFDE to produce output 
to the screen. Now we'll look at the input side— how to use the GET IN 
subroutine at $FFE< to get characters from the keyboard buffer. 
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You may be familiar with the GET statement in BASIC. If so, you'll find 
the same characteristics in GETIN: 

• Input IS taken from the keyboard buffer, not the screen. 

• If a key ts held down, it will still be detected once only. 

• The subroutine returns immediately 

• If no key is found, a binary zero is returned in A 

• If a key is found, its ASCII value will be in A. 

• Special keys, such as RETURN, RVS, or color codes, will be detected 

To call for a key from the keyboard, code JSR $FFE-^ . Values in X and 
Y are not guaranteed to be preserved, so if you have important information 
in either register, put it away into memory. 



Subroutine- GETIN 
Address. $FFE4 

Action: Takes a character from the input channel and places it 

into the A register The input channel is the keyboard input 
buffer unless arrangements have been made to switch it 

The character received is usually ASCII (or PET ASCII). When read 
from the keyboard, the action is similar to a BASIC GET statement: 
one character will be taken from the buffer; it will not be shown on the 
screen. If no character is available from the keyboard input buffer, a 
value or binary zero will be put into the A register. The subroutine will 
not wait for a key to be pressed but will always return immediately. 

Registers: The A register will of course always be affected. X and Y 
are likely to be changed; do not have data in these when calling GE- 
TIN. 

Status: Status flags may be changed. In the VIC and Commodore 64, 



If we want keyboard input to appear on the screen, we should follow a 
call to GETIN, $FFE4, with a call to CHROUT, $FFD5, so that the 
received character is printed. 

STOP 

Machine language programs will ignore the RUN/STOP key . unless 
the program checks this key itself. It may do so with a call to STOP, 
address $FFE1. This checks the RUN/STOP key at that moment. To 
make the key operational, $FFE1 must be called frequently. 
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A call to FFEl should be followed by a BEQ to a program exit so that 
the program will terminate when RUN/STOP is pressed. 

The RUN/STOP key is often brought into play while programs are being 
tested, so that unexpected "hangups" can still allow the program to be 
terminated. Coding to test the RUN/STOP key is often removed once 
testing is complete, on the assumption that no one will want to stop a 
perfect program. Incidentally, if you plan to write nothing but 100 percent 
perfect programs, you will not need to use this subroutine. 



Subroutine STOP 
Address $FFE1 

Action. Check the RUN/STOP key. If RUN/STOP is being pressed 

at that instant, the Z flag will be set when the subroutine 
returns. 

In PET/CBM, the system will exit to BASIC and say READY if the 
RUN/STOP key is being pressed. In this case, it will not return to the 
calling machine language program. 

Registers: A will be affected. X will be affected only if the RUN/STOP 
key IS being pressed. 

Status: Z signals whether RUN/STOP is being pressed. 



Programming Project 

Here's our task: we wish to write a subroutine that will wait for a numeric 
key to be pressed. All other keys (except RUN/STOP) will be ignored. 

When a numeric key is pressed, it will be echoed to the screen, and then 
the subroutine will De finished. One more thing. The numeric character 
will arrive in ASCII from the keyboard: we wish to change it to a binary 
value before giving the final RTS statement. This last operation has no 
useful purpose yet, except as an exercise, but we'll connect it up in the 
next chapter. 

Coding sheets ready? Here we go. 

.A DBBC JSR $FFE1 

We will check the RUN/STOP key first. But wait. Where will we go if we 
find that the key is pressed? To the RTS, of course; but we don't know 
where that is, yet. In these circumstances, we usually make a rough guess 
and correct it later. Make a note to check this one . . . 
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.A 033? BEQ $D351 
.A Q3A1 JSR $FFE4 

Now we've gotten a character; we must check that it's a legitimate numeric. 
The ASCII number set □ to R has hexadecimal values $3D to $3R- So 
if the value is less than $3D, it's not a number. How do we say "less 
than?" After a compare, it's BCC (branch carry clear). So we code 

.A Q3AA CMP #$3D 
.A 03-^^ BCC $D33C 

Did you spot the use of immediate mode at address $Q3AA7 Make sure 
you follow the logic on this. Another point: what if no key has been pressed? 
We're safe. There will be a zero in the A register, which is less than hex 
3D; this will cause us to go back and try again. 

Now for the high side. If the number is greater than hex 3*^, we must 
reject it since it cannot be an ASCII numenc. Our first instinct is to code 
CMP #$3*=l and BCS. But wait! BCS (branch carry set) means "branch 
if greater than or equal to." Our proposed coding would reject the digit R, 
since the carry flag would be set when we compared to a value of hex 
3q. 

We must check against a value that is one higher that $3*^. Be careful, 
though, for we're in hexadecimal. The next value is $3 A. Code it: 

.A □3-^fl CMP #$3A 
.A Q3AA BCS $D33C 

If we get this far, we must have an ASCII character from □ to let's print 
it to the screen so that the user gets visual feedback that the right key 
has been pressed: 

.A □3-^C JSR $FFD5 

Now for our final task. We are asked to change the ASCII character into 
true binary. We may do this by knocking off the high bits. We remember, 
of course, that to turn bits off we must use AND: 

.A Q3AF AND #$DF 
.A 0351 RTS 

It's a good thing that we printed the character first, and then converted to 
binary; the character must be ASCII to print correctly. 

One last thing. We had a branch (on the RUN/STOP key) that needed to 
connect up with the RTS. Did you make that note about going back and 
fixing up the branch? Now is the time to do it, but before you go back. 
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terminate the assembly with an extra RETURN on the keyboard (the 
assembler gets confused if it prompts you for one address and you give 
another; get out before you go back). 

By a fortunate stroke of luck, we happen to have guessed the right address 
for the BEQ at address $D33F. But if we hadn't, you know how to change 
it, don't you? 

Check your coding, disassemble, go back to BASIC and run with a SYS 
flEfl. Tap a few letter keys and note that nothing happens. Press a num- 
ber, and see it appear on the screen. The program will terminate. SYS it 
again and see if the RUN/STOP works. Try a BASIC loop to confirm that 
BASIC and machine language work together. 

Project for enthusiasts* Try modifying the program so that it checks for 
alphabetic characters only. Alphabetic characters run from $^1 to $5 A, 
Inclusive. 

Things You Have Learned 

—Flags are used to link instructions together. This might be an activity such 
as load or compare, followed by a test such as branch on a given condition 

—Some instructions affect one or more flags, and some do not affect flags. 
Thus, an instruction that sets a flag might not be followed immediately with 
the instruction that tests or uses that flag 

—There are four testable flags* Z (zero, or equals); C (carry, or greater/equal), 
N (negative, or high bit), and V (signed arithmetic overflow). The flags are 
checked by means of "branch" instructions such as BEQ (branch equal) or 
BNE (branch not equal) 

— Flags are stored in the status register, sometimes called the processor status 
word The S R contains the four testable flags, plus three other flags: B (break 
indicator), D (decimal mode for add/subtract); and I (interrupt lockout). The 
hexadecimal value m SR can be changed to binary and used to determine 
the exact condition of all flags. 

—Usually, the processor is interrupted sixty times a second to do special high- 
priority jobs. Everything, including the status register flags, is carefully pre- 
served so that the mam program can continue as though nothing had 
happened. 

—A number stored in memory can be considered as signed if we decide to 
handle it that way. The value of a signed number is held in iwo's-complement 
form The high bit of the number is zero if the number is positive, one if the 
number is negative The computer doesn't care It handles the bits whether 
the number is considered signed or not, but we must write our program 
keeping in mind the type of number being used. 
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—There are three logical operator instructions* AND, ORA, and EOR These 
allow us to modify bits selectively within the A register AND turns bits off, 
ORA turns bits on; and EOR inverts bits, or flips them over. 

Questions and Projects 

Write extra coding to allow both numeric and alphabetic characters, but 
nothing else. 

Write a program to accept only alphabetic characters. As each ASCII 
character is received, turn on its high bit with ORA #$&□ and then print 
it. How has the character been changed? 

Write a program to accept only numeric digits. As each ASCII character 
is received, turn off its lowest bit with AND #$FE and then print it What 
happens to the numbers? Can you see why? 
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Numbers, 
Arithmetic, 
and 

Subroutines 

This chapter discusses: 

• Numbers' signed and unsigned 

• Big numbers- multiple bytes 

• Anthmetic add and subtract 

• Rotate and shift instructions 

• Multiplication 

• Home grown subroutines 
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Numbers: Signed and Unsigned 

We have looked briefly at the question of signed versus unsigned numbers. 
The most important concept is that you, the programmer, choose whether 
or not a number is to be considered a signed number (for a single byte, 
in the decimal range -12fl to +127) or an unsigned integer (single- 
byte range □ to 255). 

It makes no difference to the computer. If you consider a number signed, 
you may wish to test the sign using the N flag. If not, you won't do such 
a test. 

Big Numbers: Multiple Bytes 

You may use more than one byte to hold a number. Again, it's your 
decision. If you think the numbers may go up to a million, you might allocate 
three bytes (or more or fewer). If you are doing arithmetic on multi-byte 
numbers, the computer will help you by signaling in the carry flag that 
there's something to be earned across from a lower byte to a higher one 
But it's up to you to write the code to handle the extra bytes. 

You may size numbers by using the following table: 
Unsigned. Signed. 

1 byte to 255 -128 to +127 

2 bytes to 65,535 -32768 to +32767 

3 bytes to 16,777,215 -8,388,608 to +8,388,607 

4 bytes to over 4 billion -2 billion to +2 billion 

It's possible to work with binary fractions, but that is beyond the scope of 
this book. Many applications "scale" numbers, so that dollar-and-cents 
amounts are held as integer quantities of pennies. Thus, two bytes un- 
signed would hold values up to $b5 5.3 5, and three bytes up to 
$lb7,775,15. 

When signed numbers are held in multiple bytes, the sign is the highest 
bit of the highest byte only. 

We will concentrate on single-byte arithmetic pnnciples here, touchhng on 
multiple-byte numbers as a generalization of the same ideas. 

Addition 

Principles of addition are similar to those we use in decimal arithmetic; 
for decimal "columns," you may substitute "bytes." Let's look at a simple 
decimal addition: 
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Rule 1 . We start at the right-hand column (the low-order byte). 

Rule 2' We add the two values, plus any carry from the previous column. A new 
carry may be generated, it can never be greater than one (ADC includes any 
carry from a previous activity, and may generate a new carry bit, which is either 
□ or 1 ) 

Rule 3. When we start at the right-hand column, there is no carry for the first 
addition (We must clear the carry with CLC before starting a new addition.) 

Rule 4 When we have finished the whole addition, if we have a carry and no 
column to put it in, we say the answer "won't fit." (If an addition sequence of 
unsigned numbers ends up with the carry flag set, it's an overflow condition.) 



HIGH BYTE 

00101011 
00001010 



LOW BYTE 

10111001 
1 1 100101 



00110110 



/ 

CARRY 

/ 



10011110 



START: 
NO CARRY 



Figure 4.1 



How do we translate these rules into machine language addition? 



1 Before we start an addition sequence, clear the carry with CLC . 

2. If the numbers are more than one byte in size, start at the low byte and work 
up to the high ones Addition will take place in the A register only; you may 
add the contents of an address or an immediate value. The carry flag will 
take care of any carries. 

3. When the addition sequence is complete, check for overflow: 

a) If the numbers are unsigned, a set C flag indicates overflow; 

b) if the numbers are signed, a set V flag indicates overflow. 

Thus, to add two unsigned numbers located at addresses $D3flD and 
$D3fll and to place the result at $D3fl2, we might code 
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CLC 

LOa $D3flD 
aOC $D3fll 
STa $D3fl5 

We might also BCS to an error routine, if desired. 

To add a two-byte number located at $D3aD (low) and $D3ai (high) 
to another two-byte number located at $D3BD (low) and $ 0361 (high), 
placing the result at $D3CD/1, we might code 

CLC 

LOa $D3aD 
aOC $D3BD 
STa $D3CD 

Loa $D3ai 

aOC $D3B1 
STa $D3C1 

Again, we might BCS to an overflow error routine 

If we had two-byte signed numbers in the same locations, we'd add them 
exactly the same way, using the same code as above. In this case, how- 
ever, we'd check for overflow by adding the instruction BVS, which would 
branch to an error routine The carry flag would have no meaning at the 
end of the addition sequence. 

Subtraction 

Subtraction might be defined as "upside down" addition. The carry flag 
again serves to linl< the parts of a multibyte subtraction, but its role is 
reversed. The carry flag is sometimes called an "inverted borrow" when 
used in subtraction. Before performing a subtraction, we must set the C 
flag with SEC. If we are worried about unsigned overflow, we look to 
confirm that the carry is set at the completion of the subtraction operation. 
If the carry is clear, there's a problem. 

Thus, to perform a subtraction, we follow these rules* 

1 Before we start a subtraction sequence, set the carry with SEC 

2. If the numbers are more than one byte in size, start at the low byte and work 
up to the high ones Subtraction will take place in the A register only; you 
may subtract the contents of an address or an immediate value The C flag 
will take care of any "borrows." 

3 When the subtraction sequence is complete, check for overflow 
a) if the numbers are unsigned, a clear C flag indicates overflow; 
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b) if the numbers are signed, a set V flag indicates overflow. 

Thus, to subtract two unsigned numbers located at addresses $03flO 
and $03 ai and to place the result at $03 52, we might code 

SEC 

LDA $D3aD 
SBC $Q3ai 
STA $0365 

A BCC could go to an error routine 

Comparing Numbers 

If we have two unsigned numbers and wish to know which one is larger, 
we can use the appropriate compare instruction— CMP, CPX, or CPY— 
and then check the carry flag. We've done this before. If the numbers are 
more than one byte long, however, it's not quite so easy. We must then 
use a new technique. 

The easiest way to go about such a companson is to subtract one number 
from the other. You need not keep the result, all you care about is the 
carry flag when the subtraction is complete. If the C flag is set, the first 
number (the one you are subtracting from) is greater than or equal to the 
second number. Why'? Because carry set indicated that the unsigned 
subtraction was legal; we have subtracted the two numbers and have 
obtained a positive (unsigned) result. On the other hand, if the C flag ends 
up clear, this would mean that the first number is less than the second. 
The subtraction couldn't take place correctly since the result— a negative 
number — can't be represented in unsigned arithmetic. 

Left Shift: Multiplication by Two 

If we write the decimal numbers and 2DD in binary, we see an 
interesting pattern:. 

To double the number, each bit has moved one position to the left. This 
makes sense, since each bit has twice the numenc "weight" of the bit to 
its right. 

The command to multiply a byte by two is ASL (arithmetic shift left). A 
zero bit is pushed into the low (or "right") side of the byte; all bits move 
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left one position; and the bit that "falls out" of the byte — in this case, a 
zero bit — moves into the carry. It can be diagrammed like this: 



CARRY - 
(C FLAG) 



T — r 



T — I — r 



J — I I I L_L 

ASL 



.0 



IN AN ASL (ARITHMETIC SHIFT LEFT), EACH BIT 
MOVES ONE POSITION LEFT. A ZERO MOVES INTO THE 
LOW-ORDER BIT. 



Figure 4.2 



That's good for doubling the value of a single byte. If a "one" bit falls into 
the carry flag, we can treat that as an overflow. What about multiple bytes? 

It would be ideal if we had another instruction that would work just like 
ASL. Instead of pushing a zero bit into the right hand side of the byte, 
however, it would push the carry bit, that is, the bit that "fell out" of the 
last operation. We have such an instruction: ROL 

ROL (rotate left) works exactly like A S L except that the carry bit is pushed 
into the next byte. We can diagram it as follows: 

CARRY 



r 



1 — I — r 



T 1 



J 1 I \ I I \ I 



CARRY 

IN A ROL (ROTATE LEFT), THE CARRY MOVES INTO 
THE LOW ORDER BIT; EACH BIT MOVES LEFT; AND THE 
HIGH ORDER BIT BECOMES THE NEW CARRY. 

Figure 4.3 



Thus, we can hook two or more bytes together. If they hold a single 
multibyte number, we can double that number by starting at the low-order 
end. We ASL the first value and ROL the remainder. As the bits fall out 
of each byte, they will be picked up in the next. 

Multiplication 

Multiplying by two may not seem too powerful. We can build on this starting 
point, however, and arrange to multiply by any number we choose. 
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ASL 

ROL f- 



^ ^ ^ ^ 4 -C LOW ORDER BYTE 

-t -* 



HIGH ORDER BYTE 

TO MULTIPLY A THREE-BYTE NUMBER BY TWO, WE 
SHIFT THE LOW ORDER BYTE WITH ASL; THEN WE USE 
ROL TO ALLOW THE C FLAG TO "LINK" FROM ONE 
BYTE TO THE NEXT. 



Figure 4.4 



We won't deal with a generalized multiplication routine here, but a couple 
of specific examples can be shown. 

How can we multiply by four? Multiply by two, twice. How can we multiply 
by eight? Multiply by two, three times. 

Here's an important one We often want to multiply by ten. For example, 
If a decimal number is being typed in at the keyboard, the number will 
arrive one digit at a time. The user might type 217, for example The 
program must then input the two and put it away; when the one arrives, 
the two must be multiplied by ten, giving twenty, and the one added; when 
the seven is typed, the twenty-one must be multiplied by ten before the 
seven is added. Result* El? in binary. But we must first know how to 
multiply by ten. 

To multiply by ten, you first multiply by two; then multiply by two again. 
At this point, we have the original number times four. Now, add the original 
number, giving the onginal number times five. Multiply by two one last 
time and you've got it. We'll see an example of this in Chapter 7 

Right Shift and Rotate: Dividing by Two 

\f >we can mu\V\p\v bv two bv shifting (and rotating) \eft, we can divide by 
two by moving the bits the other way. If we have a multibyte number, we 
must start at the high end. 

LSR (logical shift right) puts a zero into the left (high-order) bit, moves all 
the bits over to the right, and drops the leftover bit into the carry. ROR 
(rotate right) puts the carry bit into the left bit, moves everything right, and 
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T — I — r 



LSR 
— T" 



T — I — r 



J I I I I I L 




C FLAG 

IN AN LSR, ZERO MOVES INTO THE HIGH BIT, AND ALL 
BITS MOVE RIGHT ONE POSITION; THE LOWEST BITS 
BECOME THE CARRY. 

ROR 

9 r 



I T T T T T T T i 



c 



IN A ROR, THE CARRY MOVES INTO THE HIGH BIT AND 
ALL BITS MOVE RIGHT ONE POSITION; THE LOWEST 
BIT BECOMES THE NEW CARRY. 



LSR 



h 



ROR 



ROR 



TO DIVIDE A THREE-BYTE NUMBER BY TWO, WE SHIFT 
THE HIGH-ORDER BYTE WITH LSR; THEN WE USE ROR 
TO ALLOW THE C FLAG TO "LINK" FROM BYTE TO 
BYTE. 



Figure 4.5 



drops the leftover bit into the carry once again. At the end of a right-shifting 
sequence, the final carry bit might be considered a remainder after dividing 
by two. 

Comments on Shift and Rotate 

As you might expect of arithmetic instructions, the shift and rotate instruc- 
tions normally operate in the A register. But there's an extra bonus: these 
instructions also can operate directly on memory. In other words, the 
computer can go to any address in memory and shift the bits at that address 
directly, without loading the data into a register. 

For this reason, you'll often see the instructions coded with the identity of 
the A register coded in the address part of the instruction. We would code 
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LSR A so as to distinguish from LSR $123^, where the contents of 
memory is being shifted. 

When a rotate or shift is performed directly on a memory location, the Z, 
N, and C flags are affected according to the contents of memory. Z will 
be set if the contents of the location ends up as zero; N if the high bit is 
set; and C performs its standard role of catching the leftover bit. 

Some programmers wonder about the terms logical and arithmetic, used 
as part of the definition. The distinction is related to the way that signed 
numbers are treated. "Logical" means that the sign of a number will prob- 
ably be lost if the number was intended to be signed "Arithmetic" means 
that the sign will probably be preserved. It's purely a terminology question: 
the bits themselves move exactly as you would expect them to do. 

Subroutines 

We have written programs that are subroutines called by BASIC We have 
written subroutine calls to built-in operations such as $FFD2 or $FFE^. 
Can we also write our own subroutine and arrange to call it? 

Of course we can. RTS (return from subroutine) does not mean "return 
to BASIC." It means "return to whoever called this routine " If BASiC: 
called up the machine language routine, RTS takes you back to BASIC. 
If another machine language program called up the subroutine, RTS will 
return to the calling point. 

We wrote a useful subroutine in the last chapter. Its purpose was to accept 
only numeric keys, echo them to the screen, and convert the ASCII value 
to binary Now we'll use this subroutine to build a more powerful program. 
Here it is. Be sure it's entered in your computer. 



. a 


□ 33C 


JSR 


$FFE1 


. a 


□ 33F 


BEQ 


$0351 


. a 


□ 341 


JSR 


$FFE4 


. a 


□ 344 


CMP 


#$3D 


. a 


Q34fc 


BCC 


$D33C 


. a 


□ 34a 


CMP 


#$3a 


. a 


□ 34a 


ECS 


$D33C 


. a 


□ 34C 


JSR 


$FFD5 


. a 


□ 34F 


aND 


#$DF 


. a 


□ 351 


RTS 
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The Project 

Here is our mission: using the above subroutine, we wish to build a simple 
addition program. Here's how we want it to work. The user will touch a 
numeric key, say "3". Immediately, *'3 + *' will appear on the screen. 
Now the user will touch another key, say and the program will 
complete the addition so that the screen shows "3 + 4==?'*. We will 
assume that the total is in the range □ to R so that we don't have to worry 
about printing a two-digit answer — don't try 5 + 5 or you'll get a wrong 
answer 

Here we go. We must start our coding at address $0352 so as not to 
disturb our subroutine. We'll need to give SYS fl 5 □ to make this one go. 

. A 0352 JSR $D33C 

We call our prewritten subroutine, which waits for a numeric key, echos 
it to the screen, and converts the value to binary in the A register. 

Our next action is to print the plus sign We know how to do this, once 
we look up the ASCII code for this character. Appendix D tells us that it's 
$2B, so we'll need to LDA #$2B and JSR $FFD2. But wait a minute! 
Our binary value is in the A register, and we don't want to lose it. Let's 
store the value somewhere: 

.A 0355 STA $D3CD 

. A □35a LDA #$2B 

.A □35A JSR $FFD2 

.A 0350 JSR $D33C 

We picked $D3CD, since nobody seems to be using it, and put the binary 
number safely away there. Now we print the plus sign, and go back to 
ask for another digit. 

When the subroutine returns, it has a new binary value tn the A register; 
the digit has been neatly printed on the screen behind the plus sign. Now 
we need to print the equal sign. But again, wait! We must put our binary 
value away first. 

We could place the value into memory— perhaps $D3C1 would do— but 
there's another way. We don't seem to be using X or Y for anything at 
the moment, so let's slip the value across into one or the other. We have 
four "transfer" commands that will move information between A and either 
index register: 



NUMBERS, ARITHMETIC, AND SUBROUTINES 



67 



TAX— Transfer A to X TAY—Transfer A to Y 

TXA— Transfer X to A TYA— Transfer Y to A 

Like the load series of commands, these instructions make a copy of the 
information. Thus, after TAX. whatever information was in A is now also 
in X. Again like the load commands, the Z and N status flags are affected 
by the information transferred. It doesn't matter whether we use X or Y. 
Let's pick X. 

.A D3^D TAX 

.A 03^1 LDA #$3D 

.A 03^3 JSR $FFD2 

We have put our second value into X and printed the equal sign ($3D). 
Now we can bring the value back and do our addition. The next two 
instructions can come in any order: 

.A 03^^ TXA 
.A 03^7 CLC 
.A □3ba ADC $D3CD 

We have our total in the A register. It's almost ready to print, except for 
one thing: it's in binary. We want it in ASCII. 

Assuming the total is in the range □ to we can convert it directly to a 
single ASCII digit with an ORA operation. (If it's greater than nine, you're 
cheating and the answer won't make sense.) 

.A U3^B ORA #$3D 
.A 03^0 JSR $FFD2 

Are you basically a neat person'? Then you'll want to print a RETURN to 
start a new line: 

.A □37D LDA #$DD 
-A U372 JSR $FFD2 
.A 0375 RTS 

Check it with a disassembly. If you disassemble starting with the subrou- 
tine, you'll need more than one screen full of instructions to see it all. No 
problem. When the cursor flashes at the bottom of the screen, press the 
letter D and RETURN and you'll see a continuation of the listing. 

Back to BASIC. This time we do not give S Y S fl 2 fl— that's the subroutine 
and we want the main routine, remember? 

Give the SYS flSD command. Tap a couple of numeric keys that total 
nine or less. Watch the results appear instantly on the screen. 
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If you like, set up a BASIC loop and call the routine several times. 

Project for enthusiasts* You couldn't resist, could you'? You had to type 
in two digits that totaled over 9 and got a silly result OK, your project is 
to try to expand the above code to allow for two-digit results. It's not that 
hard, since the highest possible total is R + R or Ifl; so if there are two 
digits, the first one must be the digit 1. You'll need to compare for the 
result over binary nine, and then arrange for pnnting the one and sub- 
tracting ten if necessary. Sounds like fun 

Things You Have Learned 

— We may decide to use a number as a signed value; in this case, the high Dit 
of the number will be if the number is positive and 1 if the number is 
negative It's up to us As far as the computer is concerned, it's just bits in 
either case 

— When a number might have a value that won't fit into an eight-bit byte, we 
may use more than one byte to hold the value. We have already done this 
to hold addresses in two bytes* there's a high byte to hold the high part of 
the value and a low byte to hold the low part 

—We may add two numbers together using the ADC instruction with the A 
register; we should always clear the carry flag before starting an addition. 
The carry flag wHI take care of multibyte numbers for us. providing we re- 
member to start the addition at the low end 

—We may subtract two numbers using the SBC instruction with the A register, 
we should always set the carry flag before starting a subtraction. The carry— 
which IS sometimes called an inverted borrow— wW take care of multibyte 
numbers for us, providing we remember to start the subtraction at the low 
end 

—For unsigned numbers, the carry should end up as it staned (clear for addition, 
set for suDtraction), otherwise we have overflow in the result For signed 
numbers, the carry doesn't matter, the V flag will be set if we have overflow. 

—We may multiply a byte by two with the ASL (arithmetic shift left) instruction 
If we have a multiple-byte number, we may carry the multiplication through 
to other bytes Dy using the ROL (rotate left) instruction, starting at the low 
byte of the number 

—We may divide a byte by two with the LSR (logical shift nght) instruction. If 
we have a multiple-byte number, we may carry the division through to other 
bytes by using the ROR (rotate right) instruction, starting ai the high byte of 
the number 

—The shift and rotate instructions may be used on the contents of the A register 
or directly on memory. The N and Z flags are affected, and the C flag plays 
an important role in the shift/rotate action. 
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—If we wish to multiply by a value other than two, we may need to do more 

work but we can get there 
—As we might have expected, we may write subroutines in machine language 

and then call them from machine language It's a good way to organize your 

code. 

Questions and Projects 

Write a program to subtract two single-digit numbers, similar to the one 
in the above exercise. You may continue to use the subroutine from the 
previous chapter 

Write a program to input a single-digit number. If the number is less than 
five, double it and print the result. If the number is five or over, divide it 
by two (discarding any remainder) and print the result. Try to produce a 
neat output. 

Write a program to input a single-digit number. Print the word ODD or 
EVEN behind the number, depending on whether it is odd or even. Use 
the LSR instruction followed by a BCC or BCS test to check for odd or 
even 

If you've been following the logic, you have developed quite a bit of ca- 
pability in machine language. You can input, you can output, and you can 
do quite a bit of arithmetic in between. 

By now, you should have developed skills with the machine language 
monitor and feel much more comfortable zipping in and out. These skills 
are not difficult, but they are important to the beginner. Without them, you 
can never get comfortably into the real meat: how to code machine lan- 
guage itself. 



This chapter discusses: 

• Non-addresses: implied, immediate, register 

• Absolute and zero-page 

• Indexing 

• The relative address for branches 

• Indirect addressing 

• Indirect, indexed 
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Addressing Modes 

Computer instructions come in two parts: the instruction itself, or op code, 
and the address, or operand. The term "address" is a little misleading, 
since sometimes the operand does not refer to any memory address. 

The term address mode refers to the way in which the instruction obtains 
information. Depending on how you count them, there are up to 13 ad- 
dress modes used by the 650x microprocessor. They may be summarized 
as follows: 

1 No memory address, implied, accumulator 

2 No address, but a value supplied, immediate. 

3 An address designating a single memory location, absolute; zero-page. 

4. An indexed address designating a range of E5b locations. absolute,x; at)- 
solute.y; zero-page,x, zero-page,y 

5. A location in which the real (two-byte) jump address may be found: indirect 

6 An offset value (e.g., forward back 17) used for branch instructions. 
relative 

7. Combination of indirect and indexed addresses, useful for reaching data 
anywhere in memory: indirect, indexed; indexed, indirect 

No Address: Implied Mode 

Instructions such as I NX (increment X), BRK (break), and TflY (transfer 
fl to Y) need no address; they make no memory reference and are com- 
plete in themselves. Such instructions occupy one byte of memory. 

We might say that such instructions have "no address." The precise term 
is "implied address," which seems to say that there is in fact an address 
but we do not need to state it. 

Perhaps the word "implied" is used in this manner: an instruction such as 
I NX implies the use of the address register; and an instruction such as 
BRK implies the address of the machine language monitor. If so, there's 
an instruction that still defies this definition: NOP. 

The Do-Nothing Instruction: NOP 

NOP (no operation) is an instruction that does nothing. It affects no data 
registers or flags. When a NOP instruction is given, nothing happens and 
the processor continues to the next instruction. It seems inappropriate to 
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me that we say that NOP has an implied address, it doesn't do anything; 
It doesn't have an address at all On the other hand, I suppose that logicians 
might say, "Yes, but it does nothing to the X register." 

The NOP instruction, whose op code is $EA, is surprisingly useful. It's 
not simply that if you're a contract programmer getting paid by the byte 
you might be tempted to put a large number of NOP instructions into your 
program. NOP can serve two important program testing functions: taking 
out unwanted instructions, or leaving space for extra instructions. 

It's not as easy to change a machine language program as it is to change 
a BASIC program. As you have seen, the instructions are placed in specific 
locations. If we wish to eliminate an instruction, we must either move all 
the following instructions down or fill in the space with NOP instructions 
If we move the instructions, we may need to correct some of the addresses. 

Examine the following code: 

□ 35D LDfl #$□□ 

□ 352 STfl $123^ 

□ 355 ORfl $3^5b 

If we decide to eliminate the instruction at^352(STA $123^), we must 
remove all three bytes. So we place code $E A in locations □352, ^353, 
and ^35-^ 

Suppose we are testing a moderately large program Most programs will 
break into distinct "modules," each of which does a specific job. One 
module might clear a portion of memory to zero, another might do a 
calculation, and so on. When we are checking out this program, it might 
be wise to look at each module as it runs 

In this case, we might deliberately code a BRK (break) command between 
each program module. The program will start to run, and then it will break 
to the machine language monitor. Within the monitor, we can examine 
memory to ensure that this module has done the job as we planned it. 
When we are satisfied, we can start the next module using the . G com- 
mand. In this way, we can have tight testing control over our program. 

That's all very well, but when we have finished testing our program and 
are satisfied that it runs correctly, we don't want the BRK instructions 
there That's easy to fix. We replace the BRK codes ($□□) with NOP's 
($EA), and the program will run through to the end 

If we are writing a program and suspect that we may need to insert one 
or two extra instructions within a certain area of the code, we can put a 
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number of NOP instructions there The space will be available for uee 
when we need it. 

No Address: Accumulator Mode 

We have observed that the shift and rotate instructions, flSL, ROL, LSR, 
and ROR, allow data manipulation in either the A register or directly in 
memory. When we want to use the A register, or accumulator, you should 
note this fact as you code your program. For example, you would write 
flSL A. 

Where accumulator mode addressing is used, it has the same character- 
istics as implied addressing: the whole instruction fits into one byte. 

Where the shift/rotate instruction refers to a memory location, an address 
will of course be needed. These address modes will be described later. 

Other than the shift and rotate instructions, there is one other set of in- 
structions that manipulates memory directly. You may recall INX, INY, 
DEX, and DEY increment or decrement an index register. 

INC (increment memory) adds one to any memory location. DEC (dec- 
rement memory) subtracts one from any memory location. Both instruc- 
tions affect the Z and N flags. 

When an instruction modifies memory, the address mode is neither implied 
nor accumulator. Memory reference addressing will be discussed later. 

Not Quite an Address: Immediate Mode 

Coding such as LDA #$3^ does not reference a memory address. In- 
stead, It designates a specific value (in this case, $3^). An instruction 
with immediate addressing takes up two bytes: one for the op code and 
the second for the immediate value. 

We have used immediate addressing several times It has a "natural" feel, 
and it's fast and convenient. There is one potential pitfall: immediate ad- 
dressing is so easy to use that it may be abused. Each time you code an 
immediate address, ask yourself, "Could this value ever change?" By 
writing a value into a program, rather than a variable, you may be freezing 
that value forever 

An example: a program is written for a VIC-20, which has E E columns on 
the screen. At various places in the program, values are compared to EE 
(hex It), and EE is added or subtracted to various screen addresses. In 
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each case, immediate mode addressing is used to provide the value of 
22 Some time later, the programmer decides to convert to the Com- 
modore 64, which has ^ □ columns on the screen. The programmer must 
change each immediate mode reference from 22 to (hex 26). 

If the value 22 had been stored in a memory location so as to be used 
as a variable, all this receding would not be needed. The moral is clear: 
excessive use of immediate mode can call for extra programming work at 
a later time. 

There are certain instructions for which immediate addressing is not pos- 
sible For example, we can LDA #$□□. that is, bring in the actual value 
zero rather than the contents of an address, but we cannot ST A imme- 
diate — we must store the information somewhere in memory. 

A Single Address: Absolute Mode 

An instruction might specify any address within memory — from $□□□□ 
to $FFFF — and handle information from that address. Giving the full 
address is called absolute addressing; if you like, you can deal with in- 
formation absolutely anywhere in memory. 



rrMORY 



Figure 5.1 Absolute Mode Specifies One Address Anywhere Within Memory. 

We have used absolute addresses several times. When we exchanged 
the contents of memory locations $ □ 3 fl □ and $ □ 3 fi 1 , we named these 
addresses as we used them. When we stored a value from the keyboard, 
we named location $D3CD. We have also used absolute addresses for 
program control: subroutines at $FFD2 and $ 0330 were called up sim- 
ply by giving the address 

The JSR (jump subroutine) instruction calls up a subroutine anywhere in 
memory by using absolute addressing. There is also a JMP (jump) in- 
struction, which can transfer program execution to any location in memory; 
it's similar to the BASIC GOTO statement. JMP can use absolute ad- 
dressing — it can go anywhere. 

There's a limitation to absolute addressing, however. Once you have writ- 
ten the instruction, you can go only to the address stated. You cannot 
reach a range of locations: only one. 

One-location addressing can be good for any of several jobs. On the PET/ 
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CBM, we might want to switch between text and graphics modes by ma- 
nipulating address 5 q ^ b 6 (hexadecimal E 6 C). On the VIC-20, we might 
like to set the volume level of the sound generator by placing a value into 
location 3b676 (hex qODE). On a Commodore 64, the screen's back- 
ground color can be changed by manipulating address 53 E 6 1 (hex D □ E 1) 
In each case, it's one specific address that we want; absolute addressing 
will do the job for us. And we will also use absolute addressing to reference 
the various RAM locations that we have picked for our own program 'Var- 
iables " 

Zero-Page Mode 

A hexadecimal address such as $ 03 6 1 is sixteen bits long and takes up 
two bytes of memory. We call the high byte (in this case, $D3), the 
"memory page" of the address. We might say (but usually don't) that this 
address is in page 3 at position $61. 

$□□ $FF $!□□ 



Figure 5.2 Zero-Page Mode Specifies A Single Address from $DD to $FF 

Addresses such as $DD^C and $DDF7 are in page zero; in fact, page 
zero consists*of all addresses from $□□□□ to $DDFF. Page-zero lo- 
cations are very popular and quite busy. There's an address mode spe- 
cially designed to quickly get to these locations, zero-page addressing. 
We may think of it as a short address, and omit the first two digits. Instead 
of coding LDA $DDqD, we may write LDA $^0, and the resulting code 
will occupy less space and run slightly faster. 

Zero-page locations are so popular that we'll have a hard time finding 
spare locations for our own programs. As a result, we tend to conserve 
zero-page locations on Commodore machines. We'll need the few that 
are available for a special addressing mode, indirect, indexed, that will 
be discussed later. 

There are many locations in zero page that are useful to read. For example, 
the BASIC system variable ST, which is important in input/output handling, 
may be examined there (location $qb in PET/CBM, location $qD in VIC- 
20 and Commodore 64). If you need to know whether the user is holding 
down a key, there's an address in zero page that will tell you that (location 
$q7 in PET/CBM, $CB in VIC and 64). 

Zero-page addressing, like absolute addressing, references one location 
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only. It's good for a specific value; but for a range of values we need 
something more. 



A Range of E 5 b Addresses: Absolute, 
Indexed Mode 



Indexing has already been used in Chapter 2. We give an absolute ad- 
dress, and then indicate that the contents of X or Y should be added to 
this address to give an effective address. 



Figure 5.3 

Indexing is used only for data handling: it's available for such activities as 
load and store, but not for branch or jump. Many instructions give you a 
choice of X or Y as an index register; a few are limited specifically to X 
or Y. Instructions that compare or store X and Y (CPX, CPY, STX, and 
STY) do not have absolute, indexed addressing; neither does the BIT 
instruction. 

An instruction using absolute, indexed addressing can reach up to E5t. 
locations. Registers X and Y may hold values from □ to 255, so that the 
effective address may range from the address given to 2 55 locations 
higher. Indexing always mcreases the address; there is no such thing as 
a negative index when used with an absolute address. If the address given 
is above $FFDD, a high value in the index may cause the address to 
"wrap around" and generate an effective address in the region of $ □ □ □ □; 
otherwise, the effective address is never lower than the instruction ad- 
dress. 

We've seen the use of indexing. An instruction can reference a certain 
address, then, as the program loops or as the need for information changes, 
the same instruction can reference the contents of a different address. 
The maximum range of E5t. locations is an important limitation. 




VALUE 
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The "reach" of an absolute, indexed instruction allows it to handle infor- 
mation in buffers (such as the input buffer, keyboard buffer, cassette buffer); 
tables (such as the active file table); and short messages (such as HELLO 
or error messages). It's not big enough, however, to reach all parts of 
screen memory, all parts of a BASIC program, or all of RAM. For that, 
we'll use indirect, indexed addressing, which will be described later. 

All of Zero Page: Zero-Page, Indexed 

Zero-page, Indexed addressing seems at first glance to be similar to the 
absolute, indexed mode The address given (this time in zero-page) has 
the contents of the selected index added to it. But there's a difference: in 
this case, the effective address can never leave zero page 

This mode usually uses the X register, only two instructions, LDX and 
STX, use the Y register for zero-page, indexed addressing In either case, 
the index is added to the zero-page address; if the total goes beyond zero 
page, the address "wraps around " As an example, if an instruction is 
coded LDA $ED , X and the X register contains 5D at the time of exe- 
cution, the effective address will be $D03D. The total ($ED + $50 or 
$13 0) Will be trimmed back into zero page 



$00 $FF 




BASE 
ADDRESS 



Figure 5.4 

Thus, any zero-page address can be indexed to reach any other place in 
zero page; the reach of 2 St. locations represents the whole of zero page. 
This creates a new possibility: with zero-page, indexed addressing, we 
can achieve negative indexing For this address mode only, we can index 
in a downward direction by using index register values such as $FF for 
-1, $FE for - a, and so on 

On Commodore machines, zero page is fairly well occupied. There is 
limited opportunity to use zero-page, indexed addressing. 
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Branching: Relative Address IVIode 

We have written several branch instructions already, the assembler al- 
lowed us to enter the actual addresses to which we want to branch The 
assembler translates it to a different form — the relative address 



Figure 5.5 

Relative address means, "branch forward or backwards a certain number 
of bytes from this point " The relative address is one byte, making the 
whole instruction two bytes long. Its value is taken as a signed number. 

A branch instruction with a relative address of $05 would mean, "if the 
branch is taken, skip the next 5 bytes." A branch instruction with a relative 
address of $F7 would mean, "if the branch is taken, back up S bytes 
from where you would otherwise be." As a signed number, $F7 is equal 
to a value of - 

We can calculate a branch by performing hexadecimal subtraction; the 
"target" address is subtracted from the PC address If we have a branch 
at $03-^1 that should go to $ 033 0, we would work as follows: $D3 3C 
(the target) minus $D3^3 (the location following the branch instruction) 
would give a result of $FS, or mmus 7. This is tedious to do, and often 
results in mistakes; such mistakes in calculating a branch address are 
often fatal to the program run. We are much better off using an assembler 
to work out the arithmetic for us. 

The longest branches are $7F, or 127 locations ahead; and $6D, or 
12 fl locations back. This poses no difficulties with short programs, such 
as the ones we are writing here. But in larger programs, the branch may 
not be able to reach far enough The usual solution to this is to place a 
JMP (jump) instruction nearby, which is capable of going anywhere in 
memory; JMP uses absolute addressing. The appropriate branch instruc- 
tion will go to the JMP, which in turn will take the program to the desired 
location. 

Advocates of programming style make the following argument. All pro- 
grams should be written into neat small modules. Logic blocks should be 
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broken into subroutines, and the subroutines into even smaller subrou- 
tines; this way, everything is neat and testable. If you should find a branch 
that won't reach, ask yourself whether it's time to break your program into 
smaller chunks before the \og\a gets too messy By the liberal use of 
subroutines, you can arrange your code so that all branches are short and 
easily within reach If you do break up the program structure, the branches 
will then always reach It's up to you to choose your coding style, but you 
might give the question some thought. 

An interesting aspect of relative addressing is that code containing branches 
is easy to relocate. A piece of code containing a branch to six locations 
ahead will work perfectly if the whole code is moved to a different location. 
This is not true of jumps and subroutine calls, or any code using absolute 
addressing — if the location changes, the address must be changed. 

The ROM Link— Jumps in Indirect Mode 

We have mentioned the JMP instruction that will take the program to any 
specified address. JMP has another address mode: indirect addressing. 

Indirect addressing is signaled by the use of parentheses around the 
address. It works this way. An address is supplied, but it's not the one we 
will eventually use. We take this address, and at the location it specifies, 
we'll find the effective address, or the indirect address. The indirect ad- 
dress IS two bytes long, of course, and is stored in the usual 650x manner 
of low byte first. 

An example will help to make things clear. Suppose that at address $ □ 3 3 C 
we have the instruction JMP ($1E3^). The parentheses tell us that in- 
direct addressing is involved. The machine code is hex tC 3 A IE; as 
always, the address is "turned around." Now suppose that at addresses 
$1E3A and $1E35 we have stored values %EA and $tfl. The jump 
instruction would behave as follows: it would go to $1E3^ and $1E3 5, 
get the contents, and the program would transfer to address $bfl2^. 




INDIRECT 
ADDRESS 



Figure 5.6 
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The JMP indirect has a somewhat specialized use. Normally, if we want 
to transfer control to some location, we just JMP there; no need for the 
indirect step. But there's one quite important case where indirect jumps 
serve an important function. 

Within ROM, there are a large amount of permanent instructions that the 
computer uses to perform its tasks Since it's in ROM, we can never change 
this code. If the various programs were linked only tiy means of JMP and 
JSR statements, they could not be changed, and we would not be able 
to modify the behavior of the machine. 

Built into the ROM program, there are a series of carefully planned indirect 
jumps. Instead of the BOM leaping from one instruction directly to another, 
it jumps indirectly via an address stored in RAM. We can change the 
contents of RAM; and if we change the address stored in RAM, we can 
modify the behavior of the system. The best-known indirect address is 
that associated with the interrupt sequence it's at $DDRD m PET/CBM 
and $Q31A in VIC, 64, and PLUS/4. 

You might not code many indirect jumps, but you'll be glad that they are 
there in ROM. 

Data From Anywhere: Indirect, Indexed 

The problems with indexed addressing have been noted" the reach of only 
25 1 bytes limits the data capability of this method 

Indirect addressing seems to offer a total solution. We can write an in- 
struction that points at an indirect address. Since we can change the 
indirect address at will, or add to or subtract from it, we can cause our 
instruction to deal with data anywhere in memory. 

In fact, we get a limitation and a bonus. First, the limitation* for indirect, 
indexed instructions the indirect address must be in zero-page— two bytes, 
of course, organized low byte first, as always. Next, the bonus: after the 
indirect address is obtained, it will be indexed with the Y register to form 
the final effective address. 

Let's step our way through the mechanism and see how it works. Suppose 
I code LDA ($CD), Y with values $11 in address $DDCD and $22 in 
address SDDCl. If the Y register contains a value of 3, the instruction 
will follow these steps: The address at $DDCD-1 is extracted, giving 
$2211; then the contents of Y are added to give the effective address 
of $221^. If the contents of Y changed, the effective address would 
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change slightly. If the indirect address at $CD and $C1 was changed, 
the effective address would change radically. 

The combination of indirect and indexing may seem like overkill. If you 
can designate any location in memory with an indirect address, why bother 
with indexing? After all, anywhere plus one is still anywhere. 

Indirect addressing plus indexing proves to be an ideal combination for 
the manipulation of data. Almost all data breaks up into logical chunks of 
some sort: records, table entries, screen lines, words, and so on. Here's 
the technique. We position the indirect address at the start of a given 
logical data chunk, and use the Y register to scan through the information. 
When we're ready to move to the next item, we move the indirect address 
along, and repeat the same scanning of the Y register through the new 
data. 



INDIRECT, J ^ ^ 

INDEXED Y 

Figure 5,7 

One may think of it as a fishing analogy: We anchor the boat in a certain 
spot (fix the indirect address) and then use the fishing line (the Y register) 
to reach the data we need. When we're ready for the next item, we pull 
up the anchor and move along to a new place. 
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Figure 5,8 



We'll be working through an elaborate example that uses indirect, indexed 
addressing to manipulate the computer screen. First, a brief diversion. 
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A Rarity: Indexed, Indirect 

There is another addressing mode that is little used in Commodore com- 
puters" indexed, indirect. It uses the X register rather than the Y, and is 
coded as in the following example: LDA ($CD , X). In this case, indexing 
takes place first. The contents of X are added to the indirect address (in 
this case, $CD) to make an effective indirect address. If X were equal to 
^ in this example, the effective indirect address would be $DDC^, and 
the contents of $DDC^ and $DDC5 would be used as the effective 
address of the data 




INDEXED, INDIRECT ALLOWS ONE OF SEVERAL 
INDIRECT ADDRESSES TO BE CHOSEN USING 
THE X \HDEk REGISTER 



Figure 5.9 

In certain types of control processing, this is a quite useful address mode. 
X will contain an even number; since each indirect address is two bytes 
long, we will need to skip from one to the other, two bytes at a time. 

Let's take a hypothetical communications system that is connected to four 
telecommunications lines and see how indexed, indirect addressing might 
be used. Characters are being received from the four lines almost simul- 
taneously. As each character arrives, it must tie put away into a memory 
buffer belonging to that particular line; in that way, traffic received from 
the various sources won't get mixed together. Zero-page will contain four 
indirect addresses, one for each line; each indirect address points at an 
input area for one line. Suppose a character is received into the A register 
from one of the lines, the line number (times two) is in the X register. We 
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could then put the character away with the instruction STA ($tD,X). 
Thus, if line zero was involved, its indirect address at address $tD/t.l 
would be used; for line 1>, the address at $t2/t3 would be used: and 
so on. After we had stored the character concerned, we'd need to bump 
the indirect pointer so that the next character will go into a new position: 
INC $tD , X would do the tnck. 

The above example is a rather specialized use of the indexed, indirect 
address mode. You may never need to use this mode. Indeed, most 
programmers lead full, rich lives without ever writing code that uses in- 
dexed, indirect addressing. 

The Great Zero-Page Hunt 

Indirect, indexed addresses are very important. They are your gateway to 
reaching any part of memory from a single instruction. But you must have 
two bytes available in zero-page for each indirect address you want to 
use. 

The Commodore ROM system helps itself to liberal amounts of zero-page 
memory You don't have much empty space left over. How can you find 
space for these indirect pointers? 

First, look for unused locations. There are only a few of them: on the VIC 
and Commodore 64, you'll find four locations at locations $DDFCto$DDFF. 
That's enough for two indirect addresses 

If you need more, look through the memory maps for locations designed 
as "work areas" or "utility pointers." They can usually be put to work for 
a temporary job 

Finally, you can take working parts of zero-page and copy them to some 
other parts of memory You can use these locations, carefully putting back 
the original contents before returning to BASIC. Don't try this with any 
values that are used by the interrupt routines (involved with screen, key- 
board, or RS-232); the interrupt can and does strike while your machine 
language program is running And if the interrupt program changes these 
zero-page values, your program is going to behave badly. 

Project: Screen Manipulation 

This project is intended to show how indirect, indexed addressing can be 
used effectively. We'll change something on the screen — enough so that 
we reach more than 25 1 addresses. Ordinary indexing, therefore, won't 
do. 
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We'll select a number of lines on the screen; within each line, we'll change 
a certain group of characters. In other words, we will write the code so as 
to manipulate a window on the screen 

To do this, we'll need to code two steps: setting up the start of a screen 
line, and later moving on to the next line when needed. Within each line, 
we'll work our way through the range of screen columns that we have 
selected. In fact, it's a big loop (for the lines) containing a small loop (for 
the columns within that line). We'll use indirect addressing to point to the 
start of each line, and indexing (the Y register) to select the portion of that 
line to change. 

Since there's a variety of Commodore machines, we have some problems 
to resolve. All Commodore screens are "memory mapped," that is, the 
information appearing on the screen is copied directly from some part of 
memory. We may change the screen by changing the appropriate memory 
But different machines use different memory addresses; and in VIC and 
Commodore 64, the screen may be moved around. Another thing to con- 
sider IS that the length of line varies between different machines — it might 
be EE or or a □ columns. 

No problem. If you have a 40-column machine, equals $Efl; code 

.A 0330 LDA #$Efl 

For a 22-column machine, change the above toLDA#$lt; and for an 
80-column PET, code LDA #$5D. 

Have you coded the correct value? Let's proceed with our next decision. 
In the PET/CBM, screen memory starts at address SflDDD; in VIC or 
Commodore 64, the screen starts at whatever page is designated in ad- 
dress SDEflfl. Let's code as follows: 

PET/CBM: .A DBBE LDX #$flD 

.A 03^0 NOP 
VIC/Commodore 64: .A DBBE LDX $DEflfl 

The NOP instruction does nothing, but it makes the coding the same length 
so that we may continue with address $03^ 1> in either case. The A 
register tells us our line length, and the X register tells us the page number 
on which the screen starts. Let's put them away. The line length will be 
needed for addition later, so we may put it anywhere safe; the screen 
address will be part of an indirect address, so it must go into zero-page. 

It's hard to find a zero-page address that may be used in all Commodore 
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machines; we'll choose $DDBB and $DDBC. $BB contains the low byte 
of the address, of course. Let's code 

.A STA $Q3AQ 

.A U3A^ STX SBC 

Note that we are using the zero-page addressing mode for the instruction 
at address $ □ 3 ^ ^ . That puts the high byte of the address in place. Now 
we'll set the low byte to zero: 

.A U3At. LDA #$□□ 
.A U3A& STA $BB 

Our indirect address is now pointing at the start of screen memory. Let's 
discuss in more detail what we want to do with the screen. Specifically, 
we want to change a number of lines, let's say 1^, on the screen. We 
will step along our indirect address by adding to the indirect address: 
maybe 22, maybe AO, maybe flD; whatever is in address $03 AD. And 
we won't do the whole line; we'll start in column 5 and go to column Ifl. 
Let's count the lines in the X register; we'll start X at zero 

. A Q3AA LDX #$□□ 

Now we're ready to do a screen line. Later, we'll adjust the indirect address 
and come back here to do another line. We should make a note to our- 
selves; "Come back to $D3^C for the next screen line." 

The indirect address is pointing at the start of the line. We want to start 
work in column 5, That means that Y should start with an offset of A (the 
start of the line plus A), Let's do it: 

.A Q3AC LDY #$D^ 

We're going to walk Y up, and loop back to this point for the next character 
on the line. We might note; "Come back to $ □ 3 ^ E for the next character." 

We're ready to go. Let's dig out the character that's currently on the screen: 

.A 03AE LDA ($BB) ,Y 

This is worth a review. Locations $BB and $BC contain the address of 
the start of screen memory; on the PET/CBM, for example, this would be 
$ fl D D D. To this, we add the contents of Y (value A) to create an effective 
address of $flDD^; and from location $flDD^ we get the screen char- 
acter. 

We decide that we will leave spaces alone. The space character shows 
on the screen as a value of decimal 3E, hex ED. Let's skip the next 
operation if it's a space: 
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.A 0350 CMP #$2D 
.A Q3S^ BEQ $D35t 

We have to guess at the address to which we will skip ahead, since we 
haven't gotten there yet. Make a note: 'This address may need correction." 

.a D354 EOR #$flD 

This is where we manipulate the character. The EOR is a "flip-over" 
command; we're flipping the high bit of the screen value. You may look 
up screen codes to see what this does, or you may wait and see what 
happens. At this point, our code from $03 52 joins up. As it happens, we 
were lucky again: the address is exactly right to rejoin at $D3 5t. But if 
it were not, you know how to fix it, don't you? Exit the assembler, then go 
back and type over. 

Now we put the modified character back to the screen: 

.A D35t STA ($BB) ,Y 

We have done one character. Let's move along the line to the next char- 
acter, and if we have passed column Ifl (Y = 17) we should quit and go 
to the next line. 

.AD35fl INY 

-A D35R CPY #$12 

.a a3SB BCC $D3^E 

Y moves along to the next character position: five, then six the next time 
around, and so on. So long as Y is less than Ifl (hex 12) we'll go back, 
since BCC means "branch less than." If we get past this point, we have 
completed the line and must move to the next one. 

We move to the next line by adding to the indirect address. We must add 
55, or ^D, or flD; the value is in address $D3RD (you may remember 
that we stored it with the instruction at $03^1). We must rememtDer to 
clear the carry flag before starting the addition, and to add starting at the 
low byte of the address (at $BB). 

-A 0350 CLC 

.A 03SE LDA SBB 

.A DBtD ADC $D3AD 

.A 03^3 STA $BB 

.A 03^5 LDA SBC 

.A D3t7 ADC #$□□ 

.A □3bR STA SBC 
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The last three instructions seem odd. Why would we add zero to the 
contents of SBC? Surely that changes nothing. The answer is obvious 
after a little thought: there might be a carry from the previous addition. 

Now we're ready to count the lines: we had decided to use X as a counter. 
Let's add one to X, and test to see whether we have done the lines: 

-A OatB INX 

■ A DBtC CPX #$DE 

.A D3tE BNE $D3^C 

If we've done the required number of lines, we have nothing more to do 
other thar^ return to BASIC: 

.A DBTD RTS 

Disassemble and check it. Again, you'll find that the code occupies more 
than one full screen. Return to BASIC. 

This time, we'll write a small BASIC program to exercise the machine 
language code. Type NEW to clear out any old BASIC code, and enter 

IDD FOR J -1 to ID 
IID SYS flBfl 
l^D FOR K = 1 to ^QO 
13Q NEXT K, J 

The extra loop is to slow things down Machine language runs so fast that 
the effect might not be properly visible if run at full speed. 

Project for enthusiasts: Can you change the program to do a different 
set of columns? Could you change it so that it affected only the letter " S " 
wherever it appeared on the screen'? 

Comment for VIC-20 and 
Commodore 64 

This exercise will work as intended Other types of screen work might call 
for you to set the color nybble memory values before you can successfully 
work directly with screen memory. The rules for machine language are no 
different from those for BASIC' if you wish to POKE to the screen, you 
may need to take the color nybble area into account. 

Things You Have Learned 

— Three address modes are not addresses at all. Implied addressing means 
no address at all, accumulator addressing uses the A register and means 
the same thing, and immediate addressing uses a value, not an address 
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— Absolute addresses reference one location only, somewhere in memory. 
Zero-page addresses reference a single address in the range $□□□□ to 
$DDFF — the high byte of the address {□□) is the memory page. These 
address modes are used for fixed locations containing work values or system 
interfaces. 

— Absolute, indexed and zero-page, indexed allows the named address to be 
adjusted by the contents of an index register— X or Y. These instructions can 
reach a range of up to E 5 1, addresses They are commonly used for tables 
of data or temporary storage areas 

— Relative addresses are used exclusively with branch instructions. They have 
a limited "reach" of about IE? locations fonward or backward It takes a little 
arithmetic to calculate the proper values, but the computer usually works this 
out for us. 

—Indirect addressing is used only for jumps, most often to allow a fixed ROM 
program to take a vanable jump. The average machine language programmer 
will seldom need these, but the pnnciple of indirect addressing is worth learning. 

— Indirect, indexed addressing is the most important way to deal with data 
anywhere in memory. We may reach anywhere by setting the indirect address, 
then we may "fine adjust" that address tiy indexing it with the contents of Y. 

— Indirect, indexed addressing requires the indirect address to be m zero-page. 
We need to conserve zero-page locations for this use 

—An addressing mode called indexed, indirect is rarely used when program- 
ming Commodore computers, but it's there if you want it. 

Questions and Projects 

Write a program to clear the screen of your computer— check Appendix 
C for the location of screen memory if you've forgotten. Don't just print 
the clear screen character (S'^B); do it another way. Can you write the 
entire program without using indirect, indexed addressing? 

Write the program again using indirect, indexed addressing. The program 
may be a little shorter. Can you think of any other advantages of writing 
this way? 

A user wishes to type in a line of text on the keyboard, ending with a R E T U R N . 
He then wants to have the program repeat the line ten times on the screen. 
What addressing mode or modes would you use to handle the user's text? 
Why? You may try your hand at writing the program if you wish. 

Take one of the previous exercises and try to write it again without using 
immediate addressing. Is it hard to do? Can you see any reason to want 
to code without using immediate addressing at all? 



This chapter discusses: 

• Where to put a machine language program 

• BASIC memory layout 

• Loading and the SOV pointer 

• BASIC variables fixed, floating and string 

• Exchanging data with BASIC 
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Siting tlie Program 

Up to this point, we have been placing all programs in the cassette buffer. 
Thrs is a good place for short test programs, but we need to examine 
alternatives that are often more attractive 

BASIC Memory Layout 

BASIC RAM is organized according to the diagram below. The following 
locations are of particular interest: 

1. Below the BASIC area, we have the cassette buffer area This is available 
to us, providing we are not engaged In input/output activity 

2. Start-of-BASIC (SOB) is usually a fixed address within the machine In PET/ 
CBM, It's at $D^D1 (decimal 1DE5) In Commodore 64, it's at $DflDl 
(decimal In the PLUS/4 series, it's at $!□□! (decimal ^DR?) m 
the VIC-20, It may be at one of several places $D4D1, $!□□!, or $1ED1. 
A pointer marks this location. The pointer is located at $Efl/$ES (decimal 

and <1) in PET/CBM, and at $EB/$EC (decimal ^3 and ^^), in VIC- 
20, Commodore 64, and PLUS/4. 

You should inspect the pointer and confirm that it contains an appropriate 
address. You may notice that it's much easier to do this using the machine 
language monitor, since the address is split between the two bytes (low order 
first, as always). 

3 End-of-BASIC is signaled by three zero bytes somewhere after the SOB. If 
you command NEW in BASIC, you'll find the three bytes right at the start of 
BASIC, there is no program, so start and end are together. There is no 
pointer that indicates end-of-BASIC, just the three zeros; but the next location 
(SOV) will often be directly behind the end-of-BASIC 

The BASIC program that you type in will occupy memory space from start- 
of-BASIC to end-of-BASIC If you add lines to a program, end-of-BASIC will 
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move up as extra memory is taken up by your programs. If you delete lines, 
end-of-BASIC will move down 

4 Start-of-variables (S V) is often positioned directly behind the end-of-BASIC. 
When the BASIC program runs, the variables will be written into memory 
starting at this point; each variable is exactly seven bytes long A pointer 
marks this location. The pointer is located at $EA/$EB (decimal and 
^3) in PET/CBM, and at $ED/$EE (decimal ^5 and ^t) in VIC-20, Com- 
modore 64, and PLUS/4 

The SOV pointer is extremely important during BASIC load and save activ- 
ities If we give the BASIC command SAVE in direct mode, the computer 
will automatically save all memory from SOB to just before the SOV. Thus, 
It saves the whole BASIC program, including the end-of-BASIC marker of 
three zero oytes, out does not save any vanabies If we give the BASiC 
command LOAD in direct mode, the computer will automatically load the 
program, and then place the SOV pointer to just behind the last byte loaded 
In this way, variables will never be stored over the BASIC program; they will 
be wntten above the end-of-BASIC More on this later 

If the BASIC program is changed, the S V may move up or down as needed 

5. Stan-of-arrays (SOA) also represents one location beyond the end-of-BASIC 
variables, and thus could be named end-of-vanables. Arrays created by the 
BASIC program, either by use of a D I M statement or by default dimensioning, 
will occupy memory starting at this point. A pointer marks this location. The 
pointer is located at $EC/$ED (decimal and ^5) in PET/CBM, and at 
$EF/$3D (decimal ^7 and ^fl) in VIC-20, Commodore 64, and PLUS/4. 
If the BASIC program is changed, the SOA pointer is set to match the SOV 
Thus, all BASIC variables are wiped out the moment a change is made to 
the program 

6. End-of-arrays (EOA) is set one location beyond the last array location in 
BASIC. Above this point is seemingly "free" memory— but it's not really free, 
as we'll see soon. A pointer marks this location The pointer is located at 
$EE/$EF (decimal and A7) in PET/CBM, and at $31/$3E (decimal 

and 5D) in VIC-20, Commodore 64, and PLUS/4 

If the BASIC program is changed, the EOA pointer is set to match the SOA 
and SOV . Thus, all BASIC arrays are wiped out the moment a change is 
made to the BASIC program 

Let's change direction and start to work our way down from the top of BASIC 
memory. 

7. Top-of-memory (TOM ) is set one location beyond the last byte available to 
BASIC On the PET/CBM and VIC-20. its location depends on the amount 
of memory fitted; a 32K PET would locate TOM at SflDDD. On the Com- 
modore 64, the TOM will normally be located at $ADDD. A pointer marks 
this location The pointer is located at $3^/$ 3 5 (decimal 5E and 
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53) in PET/CBM, and at $37/$3fl (decimal 55 and 5t) in VIC-20, Com- 
modore 64, and PLUS/4 

If you examine the TOM pointer, you may find that it does not point at the 
expected position. That may be because of the machine language monitor, 
which has taken up residence at the top of memory and stolen away some 
memory 

8. Bottom-of-strings, (BOS) is set to the last "dynamic" string that has been 
created. If there are no BASIC stnngs, the BOM will be set to the same 
address as TOM. As new dynamic stnngs are created, this pointer moves 
down from the top-of-memory towards the EOA address A pointer marks 
this location The pointer is located at $3D/$31 (decimal ^fl and in 
PET/CBM, and at $3 3/$ 3^ (decimal 51 and 5E) in VIC-20, Commodore 
64, and PLUS/4. 

A dynamic string is one that cannot be used directly from the program 
where it is defined; you might like to think of it as a manufactured string. 
If, within a BASIC program, I type: !□□ X$ = »»HaPPY NEW YEAR", 
the BASIC interpreter will not need to store the string in upper memory; 
it will use the string directly from where it lies within the program. On the 
other hand, if I define strings with commands such as R$ = R$ + " * " or 
INPUT N$, the strings must be built into some spare part of memory. 
That's where the BOS pointer comes in: the computed string is placed 
high in memory, and the BOS moved down to mark the next free place. 

If the BASIC program is changed, the BOS pointer is set to match the 
TOM. Thus, all strings are wiped out the moment a change is made to 
the BASIC program. 

Free Memory: The Dangerous Place 

It seems to beginners that there is a great deal of free memory available 
above the end-of-arrays and below the bottom-of-strings, and that this 
would be an ideal place to put a machine language program. This is a 
pitfall: it usually won't work. 

Here's the danger. As more and more dynamic strings are created, the 
bottom-of-strings location keeps moving down. Even when strings are no 
longer needed, they are abandoned and left dead in memory, taking up 
space. 

The BOS keeps moving down. Only when it touches the EOa will the 
dead strings be cleaned up and the good ones repacked, an action called 
garbage collection. It's important for BASIC programmers to know about 
garbage collection: except on BASIC 4.0 and Commodore PLUS/4 sys- 
tems, it can be a cause of serious program slowdown. 
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It's evident that the space between EOa and BOS is not safe. If you put 
a program there, the strings will eventually destroy it. We must look else- 
where. 

Where to Put Your ML Program 

First, you may put your program in the cassette buffer. Providing you are 
not performing input/output activity, your program will be safe. Your space 
here is limited to characters or so. 
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Second, move down the top-of-memory pointer and place the program in 
the space that has been freed. Your space here is unlimited. Programs 
placed here will take up permanent residence until the power is turned 
off. Many monitors, such as Supermon, live here. 
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Third, move up the start-of-variables pointer, and place the program after 
the end of BASIC and before the new start-of-variables. Your space here 
IS unlimited. Programs placed here will tend to "join company" with the 
BASIC program; the two will save and load together. 
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After moving a pointer — as was done in the last two methods — it's a good 
idea to return to BASIC and command CLR, so that all other variable 
pointers will align correctly with the ones that have moved. 

These three areas will be discussed more in a few moments. First, there 
are one or two extra locations available to VIC-20 and Commodore 64. 

Extras for VIC and Commodore 64 

The Commodore 64 has a free block of RAM at locations $CDDD to 
$ C F F F (decimal <R155to53E<?) That's 4K of R A M not being used; 
you may write your programs there. Before you do so, check to make sure 
that the memory is not being used by any other programs It's a popular 
place in the Commodore 64, and many utilities and commerciarprograms 
zero in on this available memory. 

If you intend to write programs entirely in machine language, with no BASIC 
content at all, you may completely remove BASIC from the Commodore 
64 system and claim the space as available RAM. This gives you the 
whole block from up to $CFFF for programs and data— a whop- 

ping 94K — and even more could be liberated if necessary. BASIC may 
be made to disappear from the Commodore 64 with the equivalent of 
POKE (LDa #$3t, STA $□!). It may be reinstated with the 

equivalent of POKE 1, 55 (LDA #$3?, STa$Dl). Be very careful. 
With BASIC gone, the computer doesn't even know how to say READY. 

On all Commodore machines it s possible to move up the start-of- BASIC 
pointer and use the space freed below. To do so, it's essential to store a 
value of zero into the location immediately before the new start-of-BASIC, 
and to align all other pointers, usually by going to BASIC and commanding 
NEW. 

This works, and will make as much space available as is needed. BASIC 
programs will relocate as they load. But since the computer needs to be 
reconfigured before the main program is loaded, and often needs to be 
restored to its original configuration after the program is run, the method 
is not popular in most Commodore machines. It's used fairly often in the 
VIC-20, however. 

The video chip in the VIC-20 can "see" RAM memory only in the memory 
space $□□□□ to $1jFFF (decimal □ to filRl). Whatever variable in- 
formation appears on the screen must be taken from this memory area. 
The VIC-20 can also get information from $fiDDDto$qFFF,but there's 
no RAM there; we can't manipulate this memory area. 
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If we want to perform special visual effects on the VIC-20, we must ma- 
nipulate datainthearea $□□□□ to $1FFF. Let's look at what is available. 
$□□□□ to $D3FF is used by the "system;" other than the cassette 
buffer, we must leave it alone. $□<□□ to $DFFF contains no memory 
unless a 3K RAM expansion is added. $!□□□ to $1DFF contains the 
BASIC program, and $1EDD to $1FFF is screen memory. Details may 
vary, but the answer always comes out the same: there's no space to do 
our video effects. 

A popular VIC-20 solution, especially where 8K or more of RftM expansion 
has been added, is to increase the start-of-BASIC pointer, thus liberating 
space in low memory. This may now be used for visual effects and for 
machine language programming, too, if any space is left over. In the VIC- 
20, this approach is necessary, but it's still a bit clumsy. 



The start-of-variables pointer can be the cause of many troubles, if it's not 
understood. The rules covering it are as follows: 

1. Variables are written starting at the SOV. 

2. BASIC SAVES will save fronn mennory beginning at start-of-BASIC and stop- 
ping at SOV. 

3. Direct command BASIC LOADs will bring a program into memory, relocating 
if appropriate, and then set the SOV pointer to the location following the last 
byte loaded. 

4. Changes to BASIC programs cause memory to be moved— up or down- 
starting from the pomt where the change is made and stopping at the SOV 
The SOV will then be moved the appropriate distance up or down. 

These seem to be innocent rules. Rule 1 defines the purpose of the SOV. 
Rule 2 shows how the SOV controls the SAVE command so that the 
entire BASIC program is saved, but not the variables. Rule 3 arranges 
that short programs will have a large amount of variable space available; 
long ones will have less. Rule 4 ensures that a BASIC change makes 
extra room in memory or reclaims memory space. 

But if the SOV gets the wrong address, we're in trouble. The rules work 
against us. Variables may be written into disastrous places. saVEs will 
cause too much or too little to be saved. LOaDs may fix things, since 
SOV will be changed by the load action. An attempt to change a program 
with a bad SOV may cause too little or far too much memory to be moved 
around. We must get the SOV right. 
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How can the SO V go bad on us? Let s take three examples, corresponding 
to the three major places that we might put machine language programs: 

We have a program in the cassette buffer, and a BASIC program that 
goes with it. We enter or load the BASIC program (the SOV is all right so 
far), and then we LORD the machine language program; the SOV ends 
up disastrously somewhere in the cassette buffer area. 

We're in trouble. The program seems to list correctly, but it's sick. If we 
RUN, vanabies will start to be placed in the cassette buffer area; as more 
variables are created, they are placed in progressively higher memory 
locations. Eventually, the variables start to write over the BASIC program. 
Everything stops. The poor programmer says LIST to see what's hap- 
pened; his BASIC program is gone, and all that's left is gibberish. 

We're in more trouble. Alternatively, the programmer decides to save his 
BASIC program and commands SAVE. BASIC starts to save memory 
beginning at start-of- BASIC . . . and keeps saving, and saving, and saving. 
It won't stop until it reaches the SOV, but that's below where we started. 
We won't get there until the address "wraps around" and comes back up 
through zero. The poor programmer — if he or she waits long enough — 
discovers that the tiny five-line BASIC program has been saved as over 
55 □ blocks on disk, or fifteen minutes worth of tape. And the saved 
program is useless. 

We're in still more trouble. Alternatively, the programmer lists the program, 
and decides to delete one character from a line of BASIC. BASIC im- 
mediately starts to move memory, starting at the change point. It won't 
stop moving memory until it reaches SOV, but that, again, is below where 
we started. It will move everything that can be moved. RAM will be moved 
along, which may not hurt anything; then the lA chips will be moved, 
which may scramble colors or make the display go crazy; then it will try 
to move ROM, which won't work because ROM can't be changed; then it 
will wrap around to zero-page and move everything there, which is fatal 
to the system. Eventually, it will collapse before reaching SOV since it 
destroys its own working pointers. 

All this could have been avoided if the programmer had loaded the machine 
language program first, and then loaded the BASIC program. The SOV 
would be placed behind the BASIC program, which is where it belongs in 
this case. 

Quiet Interlude 

It's easy to see how the problem occurs, once you understand about the 
SOV and its role. But if you don't understand the SOV, the results can 



LINKING BASIC AND MACHINE LANGUAGE 



99 



shake your self-confidence. Many programmers have given up on machine 
language because of a bad experience with SOV . 

It works this way The student writes a perfect program into the cassette 
buffer and saves it using the machme language monitor Later, with a 
BASIC program in place, the student recalls the program and inadvertently 
moves SOV to an impossible location. When BASIC runs, the variables 
will start to be written behind the machine language program, ahead of 
the BASIC program. As more and more variables come into play, they 
creep relentlessly toward the BASIC coding. 

Our eager student — with a perfect machine language program and a per- 
fect BASIC program— now decides to say RUN. The BASIC program runs 
for a while, and then grinds to a halt, usually with a crazy screen or reporting 
an error in a nonexistent line. We know what's happened, of course: the 
variables have started to write over the BASIC program. But our unfor- 
tunate student doesn't know that. The command LIST is entered, and 
out comes nonsense 

What goes through the programmer's mind at this time? "I was so sure 
that the program is correct [in fact, it is]; but it's so bad that it's destroyed 
memory! I suppose that machine language is much more difficult than I 
thought." 

And the student loses hope and gives up, not knowing that there's only 
one small piece of information needed to fix everything up. This is only 
one of the things that might go wrong when the SOV pointer is improperly 
placed; even an attempt to change or save a BASIC program can cause 
system failure. 

Such experiences destroy confidence. They are responsible for the myth 
that machine language is hard and only super-clever programmers can 
cope with it. 

The Machine Language Monitor SAVE 

Now that we're becoming aware of the SO V pitfall, we're ready to discuss 
how to save a program in machine language. You probably understand 
why I've been delaying this command until this time. The MLM save com- 
mand typically goes 

.S »»PR0GRAM»»,Dl,D33C,D3tl 

This would be the tape format. The command is . S and is followed by 
the program name. The device is tape, so we type □!— be sure to give 
two digits. Next comes the beginning address (in the example $D33C) 
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followed by the end address plus one. In the example, the last location 
saved will be $D3tD. For disk saves, we might want to add the drive 
number: 

.S '»D:PROGRaM»',Dfi,D33C,D3tl 

These programs, once saved, may be loaded directly from BASIC, but 
watch the SOV carefully. VIC-20 and Commodore 64 BASIC LORD com- 
mands should contain the extra field to defeat relocation: LORD »'PRO- 
G R a M " , fi , 1 will insist that the program load back into the same memory 
locations from which it was saved 

More on LOAD 

There is a machine language . L command to do a program load without 
changing any pointer (especially SOV). There are a number of different 
machine language monitors around, and the . L command does hot work 
the same way on all of them. You might check out the one you are using: 
ideally, the .L command (format: .L "PROGRRM", 01) should bring 
back the program wthout relocation. 

The . L command is of limited value. A program user often cannot be 
expected to load up a machine language monitor and use it to go through 
a . L load sequence. The program should take care of things for the user. 

We have been careful to say that the BASIC LORD command changes 
the SOV when given as a direct command. If a LORD command is given 
from within a program, SOV is not changed; but there's a new item to be 
taken care of. 

Programmed LORD has been carefully designed to perform a function 
called "chaining." That's a BASIC technique, and not within the scope of 
this book. Chaining, however, has two important characteristics: 

1 No pointers are affected. The program will not lose any variables when it 
perfornns a LOAD. That's good: we will not lose any of our computations. 

2 Once a LOAD is complete, the BASIC program will resume execution at the 
first statement It will not continue from where it left off; it will go back to the 
beginning. For our application, that's bad; we seem to have lost our place 
in BASIC. 

If we understand the problem that item 2 creates, we can easily fix it by 
using item 1. Here's an example to illustrate the problem: we have a 
program on disk written for the cassette buffer called "ML", and we want 
to have a BASIC program bring it in. We could code as a first line: !□□ 
LORD " ML '* , fi — but we'd have a problem. First, the program would load 
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ML. Then it would go back to the beginning and load ML. Then it would 
go back to the beginning . and so on. This is not satisfactory. Let's use 
rule 1 to fix everything: 

IDD IF A = l GOTO 13U 
IID A-1 

15D LOAD "ML",fl,l 
13D . . . continues 

When we say RUN, the first line is executed. A is not equal to one, so 
we continue on line IID . A is set to one, and line lED causes a load 
of the desired program. BASIC goes back to the beginning, but all variables 
are preserved, so A is still equal to 1. Line IDD tests A and goes to line 
13D, the next statement beyond the load. Everything works as required. 
If there are multiple LOADs, line IDD might be changed to IDD ON A 
GOTO 13D , 15D , 17D . . . as necessary. 

Caution: we are discussing the programmed LOAD command only in the 
context of loading machine language modules. If you want to have a 
program load in another BASIC program (chaining or loading) the above 
rules still apply but may need to be used differently. 

Other SOV Blunders 

We have discussed the horrible results of loading a machine language 
program into the cassette buffer (using a direct command) after BASIC 
has been loaded. By now, we should have learned to avoid making this 
mistake. What about programs stored in other areas, such as high memory 
or after BASIC? 

Suppose we want to place a program into high memory, either by moving 
the top-of-memory pointer down to make room, or by using the spare RAM 
at $CDDD to $CFFF of the Commodore 64. We also have a BASIC 
program to load. Will loading in the wrong order harm SOV? 

The answer is yes, although the problem is not so severe. You can see 
that after loading a program to high memory using a direct command, 
SOV will be positioned immediately above it. But that's too high— there's 
no room for variables and we'll get an OUT OF MEMORY error for alrnost 
anything we do. 

Obviously, we can't leave SOV in the upper stratosphere. We must load 
the high memory first, and then the^ BASIC program. The second load will 
straighten out the SO V pointer. If you try this, you'll find that it is necessary 
to fix up the top-of-memory pointer and command NEW between the two 
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loads; you cannot even give the next LOAD command if you're apparently 
totally out of memory. 

Review: Fixing Pointers 

If In doubt, examine the pointers by displaying them with a . M command. 
For VIC/64/PLUS/4, the command would be .M DDEB 003 A; with 
PET/CBM, use . M DDE fl 003 7; in either case, be sure that the start- 
of-variables pointer is set to a "sound" value. 

As always, you can change an incorrect memory value — in this case, an 
incorrect vector — by moving the cursor back, typing over the values to be 
changed, and pressing RETURN. 

After End-of-BASIC— Harmony 

Suppose we place the machine language program behind the end-of- 
BASIC— that's the three zeros in memory— and move up the SOV so that 
variables won't disturb this program. How will everything work now? 

Things will work very well indeed. This time, we need to load our BASIC 
program first; the SOV will go immediately behind BASIC. Then we may 
load our machine language program, and the SOV moves right behind it. 
The SOV is in exactly the right place, assuming we load in the right order. 
(If we don't, the variables will destroy our machine language program.) 

Once our two programs are together, and we say SAVE, the combination 
program— BASIC and machine language together— will be saved. A little 
thought will reveal that memory from start-of-BASIC to just before start- 
of-variables contains everything we need. A subsequent load will bring 
everything back in, and position SOV to exactly the nght place. We now 
have a "unit" program— BASIC and machine language working together, 
loading and saving as one program. 

There's one small problem in this arrangement. Once we have married 
the BASIC and machine language programs, we must not change the 
BASIC program. If we added to or subtracted from this program, the 
machine language program would move up or down— the relocation of 
memory goes right up to SOV. The program might not be able to work in 
the new place, and, of course, our SYS commands would be wrong. 

BASIC Variables 

There are four types of entry in the BASIC variable table. All variables, 
regardless of type, occupy seven bytes; the first two bytes are the name. 



UNKING BASIC AND MACHINE LANGUAGE 



703 



and the remaining five bytes (not always fully used) contain the value or 
definition. The variable type is signaled as part of the name: high bits are 
set over one or both letters of the name to signal a specific type 



SOV 



SOA 



EACH VARIABLE IS EXACTLY 7 BYTES LONG. 
VARIABLES APPEAR IN THE ORDER IN 
WHICH THEY ARE USED. 

Figure 6.5 

For example, if a floating point variable had a name AB, the name would 
be stored in the two bytes as $4 1 ^ $4 5— the ASCII codes for A and B. 
The same would be true if the variable were named ABACUS, since only 
the first two letters of the name are kept. In contrast, if the variable were 
named AB^, meaning that it was an integer variable, the name would be 
stored as $C1 , $C5. The ASCII codes are the same, but the high bit 
has been set over them. To complete the picture, a string variable named 
AB$ would be coded with the name $^ 1 ^ $C5— the high bit is set over 
the second character only 



"HIGH BIT SET FOR INTEGER VARIABLES AND FUNCTIONS 
HIGH BIT SET FOR INTEGER AND STRING VARIABLES 
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Figure 6.6 



There's a fourth type of entry that can go into the variable table, but it's 
not a variable: it's a function definition. If we give the variable command 
DEFFNA ( . . . an entry will be made in this table. It will be distinguished 
by the high bit being set over the first character only. 

String variables use only three of the five bytes provided; the first byte 
signals the length of the string, and the next two bytes give the string's 
address. This group of three bytes is called a aescriptor. 
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There are two types of numeric variables: floating point and integer. Float- 
ing point variables use all five bytes; integer variables use the first two 
bytes only. It's possible to extract the value from a floating point variable 
and put it to work, but it's not a simple procedure. A description of how 
to do this IS given in Appendix F. In contrast, it's quite easy to take the 
value from an integer variable and use it. 

Let's try an example. Type NEW, followed by A = 5 : = 5. This creates 
two different variables: A and B%. Now go to the machine language mon- 
itor. The variables should be near the start-of-BASIC, but if you wish you 
can find their exact address by examining the SOV pointer ($E A/$EB on 
PET/CBM, or $5D/$5E on VIC, Commodore 64 or PLUS/4). On the 
Commodore 64, we might find that the variables start at $ □ fl □ 3 ; to display 
both of them, we type .M DflD3 DfllO. We see the floating point 
variable. A: 

Al □□ fl3 5D □□ □□ □□ 

The first two bytes are the name — A 1 is ASCII for A, and the zero signifies 
no second letter — but where's the 5? Embedded within the fl3 ED □□ 
□ □ □□, that's where; and it's a good deal of work to extract the 5 for 
further processing. 

Behind this variable, we see the integer variable, B: 

CE flD □□ 05 □□ □□ □□ 

Hex CE is the ASCII for the letter B (4E) with the high bit set. flD is zero 
with the high bit set — again, there's no second letter. The value is in the 
next two bytes, and it's easy to read. The last three bytes are not used. 

Which is easier for machine language to interface with? Obviously, the 
integer variable. It's often quite suitable for the program work at hand: 
counting characters, setting pointers, and similar tasks. 

Exchanging Data: BASIC and Machine 
Language 

If BASIC and machine language wish to pass data back and forth, there 
are several approaches. Perhaps the simplest is to have BASIC POKE 
the values into a given location, and machine language load them as 
needed; in the opposite direction, machine language will store the values 
and BASIC will PEEK them. 

Another method is more sophisticated. BASIC variables are stored in 
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memory: why can't a machine language program go after the variables 
exactly where they lie and extract their value or change them? It sounds 
like a good idea. 

By now, we know how to ask machine language to search for a specific 
BASIC variable. Given the name, we can get the address of the first 
variable from the SOV pointer and store it as an indirect address. Using 
indirect, indexed addressing and stepping the Y register from □ to 1 we 
can see if the name matches. If not, we add seven to the indirect address 
to take us to the next variable. If it does match, our indirect address is set 
up at the start of the variable; we can set Y to 5 , 3 , A, 5 , and and 
extract the whole value. If the variable is type integer, we need only extract 
the first two bytes (Y = 5 and 3). If the variable is not in the variable table, 
we'll step our indirect address until it matches the start-of-arrays; at that 
point, we know that we have missed the variable 

For a small number of variables, there's a short cut. Variables are placed 
into the variable table in the order in which they are defined: whichever 
variable is defined first in the BASIC program will be first in the variable 
table. So if we arrange for our variables to be defined in a certain order, 
we can streamline our machine language search to "first variable," "sec- 
ond variable," and so on, with no need to examine the names 

Let's take this one step further. If we want to use the first variable, all we 
need to have is the address of the first variable somewhere in zero-page 
so that we may use it as an indirect address. We already have that ad- 
dfQS$—Ws the SOV, the start-of-variables, and it's there pointing helpfully 
at the first variable for us. By increasing the value of Y appropriately, we 
can reach beyond the first variable and into the second or, for that matter, 
the third or the thirty-sixth. 

Project: We plan to place the machine language program behind the end- 
of-BASIC. This will vary, depending on the machine being used. The 
following code shows the correct addresses for the Commodore 64. Refer 
to Appendix E for other machines. 

First, let's do our BASIC coding to estimate its size. We need to guess at 
the location of the end-of-BASIC so as to place our machine language 
program. This program will ask machine language to take a value, V^, 
and multiply it by ten. Remember to say NE W. We write the BASIC program 
as follows: 

!□□ V^-D 

IID FOR J = l TO 5 

15D INPUT "VALUE**^; Y% 
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13D SYS + + + + 

14 □ PRINT "TIMES TEN" = " ; 

15DNEXT J 

It seems likely that our BASIC program will occupy less than IE"? bytes. 
We may check this later, but it seems safe to plan to start our machine 
language program at around + 157,or E17t3 (hexadecimal flflD). 
On that basis, we may change line 13 □ to SYS 517 ti. Do nof try to run 
the program yet. 

At this point, we could save the BASIC program to tape or disk and develop 
the machine language program. This would allow us to refine each of the 
two parts independently. For the sake of brevity — and because our ex- 
ample is an easy one and won't need touching up — we'll write the machine 
code directly into memory. 

Switch into the machine language monitor. Assemble the following code: 



• A 


□ flflO 


LDY 


#$0E 




.A 


□aaa 


LDA 


($2D) , 


Y 


.A 




STA 


$D33C 




.A 


□flfl? 


STA 


$033E 




.A 


□ flflA 


LDY 


#$03 




.A 


OflflC 


LDA 


($2D) , 


Y 


.A 


□ flflE 


STA 


$D33D 




.A 




STA 


$033F 





We have now extracted two bytes from the first variable, Y%. The high 
byte has been stored at both $D3 3C and $D3 3E; we'll see why in a 
moment. The low byte of the value has gone to $ 03 3D and $D3 3F. 

Project for enthusiasts: You might be able to code the above more com- 
pactly by more effective use of indexing. 

.A Dflq^ ASL $D33D 

.A 03^7 ROL $D33C 

.A DflqA ASL $D33D 

.A Dfl^D ROL $D33C 

We have multiplied the contents of $D33D/$D33C by two, and then we 
have multiplied it by two again. These locations now contain the original 
value times four. Note that we ASL the low byte and then ROL the high 
byte. Perhaps we should be checking for overflow; but let's trust the num- 
ber to be within range for now. 

Since we have the original number times four in $D3 3D/$D3 3C, we can 
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add It to the original number in $D33F/$D33E to get the original number 



times five: 






.a 


□aao 


CLC 




. a 


□aai 


LDa 


$□330 


.a 


Dfla^ 


aDC 


$D33F 


. a 


□aa? 


STa 


$D33D 


.a 


□aaa 


LDa 


$D33C 


.a 


DaaD 


aDC 


$D33E 


. a 


□ aBD 


STa 


$D33C 



Now locations $ 03 30/$ 03 3D contain the original number times five. If 
we double the number one last time, we'll have the value times ten: 

.A 0363 ASL $D33D 
.A □flBt3 ROL $D33C 

We have multiplied the number by ten. Now let's put it back into the variable 



.a 


□aBq 


LDY 


#$D2 


.a 


□ aBB 


LDa 


$D33C 


. a 


□aBE 


STa 


( $2D) , Y 


.a 


□ acD 


LDY 


#$□3 


.a 


DaC5 


LDa 


$D33D 


.a 


□ ac5 


STa 


($5D) ,Y 


.a 


□ ac? 


RTS 





The numbers go back exactly the same way we drew them out. We must 
be careful to keep the high and low bytes correct. Integer variables have 
the high-order byte first, followed by the low-order byte; this is exactly the 
reverse of the way we use 650x addresses. 

We must perform one more task before wrapping up the program. We 
must change the state-of-variables pointer to a location above the machine 
language program. That would be $DflCfl, and so we display the SOV 
pointer with .M DD^D DD^E and change the pointer to 

. :DD5D Cfl Dfl 

Check . . . disassemble . . . and then back to BASIC. List, and you'll 
see your BASiC program again. There's no sign of the machine language 
program, of course, but SAVE will now save everything together. 

RUN the BASIC program. Enter numbers as requested. Confirm that they 
are multiplied by ten. 

You may recall that our machine language program does not check for 
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overflow. RUN the program again, and see if you can find the highest 
number that can be multiplied by ten without error. What happens at time 
of overflow? Is it what you expected? 

Project for enthusiasts: Can you add checks for overflow to the above 
program? You must decide what to do if overflow occurs: print a message; 
set the value to zero; or whatever you decide. But you shouldn't stop the 
program or break to the monitor. Such a thing would upset the program 
user. Your program will be longer. Don't forget, therefore, to change the 
SOV pointer at $2D/$5E so that your program is safe from variables 

Things You Have Learned 

— Small machine language programs can be conveniently written and checked 
out in the cassette buffer. We have been doing this during the exercises This 
area is not satisfactory for large programs, or programs we want to save on 
tape, 

— Programs can take up semi-permanent residence near the top-of-BASIC 
memory: the top-of-memory pointer needs to be moved down to protect it 
These programs often need a separate "setup" to place them. 

—Programs can be placed behind the end-of-BASIC, which is marked by three 
consecutive zero bytes m memory. The start-of-variables pointer must De 
increased so that vanables don't write over the program Care must be taken 
not to change the BASIC program after this is done. 

—The VIC-20 frequently has the start-of-BASIC moved up to make room for 
video information in lower memory. As long as we're moving this pointer, we 
might move it a little further and make room for some machine code. 

—The Commodore 64 has an unused block of RAM at addresses $CDDD to 
$CFFF; check to see that no other programs are using this area. 

—The start-of-variables pointer is intimately tied in with BASIC'S SAVE and 
LOAD commands. It is extremely important to ensure that any LOAD se- 
quence leaves this pointer in a safe place, so that variables cannot write over 
program code and thus cause program destruction. 

—Machine language monitor . S (save) and . L (load) commands can be used 
for staging programs in various parts of memory. Again, great care should 
be taken to ensure that the pointers are sound after the use of such instruc- 
tions. 

—A BASIC program may contain LOAD commands that will bring in any of the 
following: a different BASIC program, a machine language program, or data. 
Again, careful handling is needed. 

—BASIC variables are of three major types, integer, real (floating point), and 
string. Machine language programs are capable of reading and using any of 
them; in particular, integer variables are quite straightforward. 



LINKING BASIC AND MACHINE LANGUAGE 



109 



— If we want, we can simplify the task of searching for BASIC variables by 
deliberately creating tfiem in a certain sequence. 

Questions and Projects 

Write a simple BASIC and machine language program set that allows 
BASIC to input a number less than ESti; POKE it somewhere in memory; 
call machine language that will divide the number by two; PEEK it back 
and print it. 

A program that brings in other programs is called a "boot," or, more 
accurately, a bootstrap program. Write a simple BASIC boot program to 
bring in a previous program exercise that was located in a cassette buffer 
(say, the program from Chapter 2 that printed HELLO), and then call it 
with a SYS. 

Bootstrap programs are especially popular with VIC, Commodore 64, and 
PLUS/4 for bringing in chunks of data such as sprites, new character sets, 
or whole display screens of information. You might like to try your hand 
at setting up such a system. 

Try your hand at this. I have a BASIC program that reads 

1DDX=5 
IID SYS ... 
lED P HINT A 

Write the machine language to be called by the SYS so that it changes 
the name of the variable X to A. Caution: this may be fun, but it's dangerous 
in real programs since you may end up with two variables that have the 
same name. 



This chapter discusses: 

• The stack for temporary storage 

• USR: an alternative to SYS 

• Interrupts: IRQ, NMI, and BRK 

• The lA chips- PIA and VIA 

• Infiltrating BASIC: the wedge 
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Brief Intermission 



If you have been following along and performing the vanous projects, you 
should know a great deal about the principles of machine language. You 
should be capable of trying your hand at a number of small projects, and 
investigating areas that may be of special interest. 

This is a good time to stop and take stock. The remaining chapters are 
"icing on the cake" . . . they give extra detail and fine tuning on aspects 
of machine language. If you feel uncertain about any matenal covered so 
far, go back Fix the fundamentals firmly in focus before you proceed and 
plunge into ponderous points of interest. 



Temporary Storage: The Stack 



The stack is a convenient place to put temporary information. It works like 
a stack of documents: you may drop (or "push") an item onto the stack; 
when you take an item back again (or "pull"), you'll get the last one that 
you put there. Formally, it's called a last-in, first-out (LIFO) discipline; it's 
natural and easy to understand. 

The important rule to keep in mind about the stack is: "Leave these prem- 
ises as clean as when you found them." In other words, if you push three 
Items onto the stack, be sure you pull those three items back off again. 
Don't ever branch away and leave the stack littered. 

The stack is in memory at page 1. The stack pointer (SP) is one of the 
Items displayed in the register. To look for the information on the stack, 
you must add $ □ 1 □ □ to the value to get the next available stack position. 
As an example, if the SP shows a value of $Ffl, the next item to go on 
the stack will go into address $DlFfl; the moment we put an item onto 
the stack, the pointer will move down so that it becomes $F7. 

As the stack is filled, the stack pointer goes down. As the items are brought 
back out of the stack, the stack pointer goes up. A low value in the stack 
pointer means a full stack, a value below $A0 signals trouble. 

The 650x chip itself doesnit give the stack any special treatment. If a 
machine language program— probably because of a coding error— wanted 
to push one thousand items onto the stack, that would be OK as far as 
the microprocessor was concerned. The stack would never leave page 1 : 
as the stack pointer went down beyond zero, it would wrap around to $FF 
and keep going. You'd never get those thousand distinct items back, of 
course. Similarly, if a program wanted to pull a thousand items from the 
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SP 



NEXT ITEM 
PUSHED WILL GO . , 

TO ADDRESS $01 F8 i i 

NEXT ITEM 
PULLED WILL COME 
FROM ADDRESS $01 F9 

Figure 7.1 

stack — whether or not they had been put there before — the processor 
would happily move the stack pointer round and round page 1, delivering 
bytes. There would only be E5t different values delivered, of course, but 
the processor doesn't care. 

Within the BASIC environment, the stack pointer stans around $FA (the 
first item will go into the stack at address $D1FA), and goes down from 
there. When the stack pointer goes below about $^ BASIC will signal 
OUT OF MEMORY. That's over ItO available locations on the stack, 
plenty of room for most applications 

PHA (push A) and V LA (pull A) 

How may we use the stack? Suppose we have a value in the A register 
and in a moment we will want to use it. First we need to print something, 
and the character to be printed must be loaded into the A register How 
can we put away the value in A and bring it back later? We could slip it 
into another register with a transfer instruction (TAX or TAY) and bring 
It back from there; or, we could store it into memory and load it back. 
Alternatively, we could PUSH the A register (PHA) to the stack and PULL 
(PL A) the value back later. 

Again, let's do an example. Suppose the A register contains 5, and the 
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01 FA 
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01F9 


FREE 
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stack pointer is at $F3. If the program says PHA, the value 5 is stored 
at address $D1F3, and the stack pointer changes to $FE. Later in the 
program, we encounter the instruction PLA: the stack pointer moves back 
to $F3 and the value 5 is read from address $D1F3 and placed into 
the A register. 

It's a handy way to put away a value in R for a moment. 

PHP (push processor status) and PLP 

Sometimes when we are wnting a program, we want to test for a condition 
now but act on the result of that test later. We can arrange to do this by 
putting the flags away for the time being, and then bringing them back 
when we want to test the flags. We use the instruction PHP (push the 
processor status word) to place all the flags on the stack, and PLP (pull 
the processor status word) to restore the flags to the status register (SR). 

Why would we need to do this? Perhaps an example will illustrate. Suppose 
we are reading a file of customer purchases, and as we input a data item, 
we discover that this is the last one — it's the end of the file. That means 
that we want to close the file and summarize the customer's activity — 
though not just yet. First, we must handle the item of information that we 
have input. So we can "stack" our end-of-file information, handle the last 
record in the same way as previous records, then bnng back the status 
to see whether it's time to close the file and print the totals. We'll be using 
PHP and PLP for exactly this kind of task in the next chapter 

PHA and PHP both put exactly one item onto the stack; PL A and PLP 
pull one item. There are other commands that handle more than one stack 
location. 

JSR and RTS 

We know these commands. What are they doing here'^ 

When a JSR command is executed, the return address is placed onto 
the stack. When an RTS command is executed, the return address is 
picked from the stack, and that's where the program returns to. 

More precisely, when a JSR occurs, the processor places onto the stack 
the return address minus one as two bytes; the high-order part of the 
address goes to the stack first. When an RTS is encountered, the pro- 
cessor takes the two bytes from the stack, adds one, and then proceeds 
from the address so formed 

Example: If address $0352 contains the command JSR $D33C, the 
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following events occur. The return address would be $ 03 5 5, the instruc- 
tion directly behind the JSR; but an address of $035^ is calculated— 
the 03 goes to the stack first, and the SA below it. The subroutine at 
$D33C now starts to run. Eventually, it encounters an RTS. The values 
SA and 03 are pulled from the stack and formed into address $03 5^; 
one IS added, and the processor resumes execution at address $03 55. 

You hardly need to know this. We have been using subroutines for some 
time without knowing that all this happened. But sometimes, it's useful to 
be able to examine the stack, asking, "Who called this subroutine'?" The 
answer is there. 

Interrupts and R T I 

There are three types of interrupt: IRQ, NMI, and the BRK instruction. 
IRQ (interrupt request) and NMI (non-maskable interrupt) are pins on 
the 650x. A suitable signal applied to the appropriate pin will cause the 
processor to stop what it's doing and run an interrupt routine. The BRK 
instruction might be thought of as a fake interrupt — it behaves in a similar 
manner to IRQ. 

When an interrupt signal occurs, the processor completes the instruction 
it is currently working on. Then it takes the PC (the program counter, which 
contains the address of the next instruction) and pushes it onto the stack, 
high byte first. Finally, it pushes the status register to the stack. That's a 
total of three bytes that go to the stack. 

The processor then takes its execution address from one of the following 
locations: 

IRQ or BRK— from $FFFE and $FFFF 
NMI —from $FFFA and $FFFB 

Whatever value is found in these pointers becomes the interrupt execution 
address* the processor starts to run at this address. Eventually, the pro- 
cessor encounters an RTI instruction. The status register and the PC 
address are taken from the stack, and the interrupted program resumes 
where it left off. 

Note that the address on the stack is the return address. This differs from 
JSR/RTS, where the return address minus one is stored. 

On all Commodore machines, the I RQ strikes about sixty times a second. 
The NMI is unused (but available) on PET/CBM; it isn't available in the 
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264 series; and on VIC-20 and Commodore 64, it is used for the RE- 
STORE key and for RS-232 communications. 

The BRK command can be distinguished from the IRQ signal by means 
of a bit m the status register. Bit ^ is the B, or break flag: if it's set. the 
last interrupt was caused by a BRK and not by an IRQ. 

Later, we will discuss using the interrupt routines for our own programming. 
By the time we can "catch" the interrupt, several more things will have 
been pushed to the stack: the A, X, and Y registers. This is done by a 
ROM program, not the processor; but it will prove handy since we can use 
these registers, safe in the knowledge that they will be restored at the end 
of the interrupt. 

Mixing and Matcliing 

The processor uses the stack mechanically. If we know how to manipulate 
the stack, we can use it for surprising things. For example, an RTS can 
be given even though there was no subroutine call; all we have to do is 
prepare the stack with the proper address. Try to figure out what the 
following code will do: 

LDA 
PHA 

LDA #$tfl 

PHA 

RTS 

This coding is identical toJMP$E^tS.We have placed a "false return 
address" onto the stack, and RTS has removed it and used it. This may 
not seem very useful, since we could easily have coded the JMP 
directly. But look at the following code: 

LDA TABLEl, X 
PHA 

LDA TABLED, X 

PHA 

RTS 

The principle of coding is the same, but now we can "fan out" to any of 
several different addresses, depending on the value contained in X. 

us R: A Brother to SYS 

We have used SYS a number of times, it means, "Go to the address 
supplied and execute machine code there as a subroutine." U S R is similar 
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in many respects: it nieans, "Go to a fixed address and execute machine 
code there as a subroutine," The fixed address may be POKEd into the 
USR vector. On most Commodore machines this is at addresses 1 and 
E; on the Commodore 64, it's at addresses 7&S and 7flt (hex 0311 
and Q31E). 

There's another difference that seems important at first. SYS is a com- 
mand; USR is a function. You cannot type the command USR ( □ ) — all 
you'll get is SYNTAX ERROR. You must say something like PRINT 
USR ( □ ) or X = USR ( □ ), where USR is used as a function. It seems 
as if S Y S was meant to connect to action programs, and USR was meant 
to link to evaluation programs. In reality, the difference in usage is not that 
great. 

Whatever value is within the parentheses — the argument of the U S R func- 
tion — is computed and placed into the floating accumulator before the 
USR function is called. The floating accumulator is located at $5E to $ t3 
in most PET/CBM computers, and at $bl to $bb in VlC-20, Commodore 
64, and PLUS/4. Floating-point representation is complex, as we have 
hinted in Chapter 6. Most beginning programmers prefer to leave this area 
alone and pass values through memory POKEs or integer variables. 

When the USR function returns control to BASIC, the function value will 
be whatever is in the floating accumulator. If we have not modified it, this 
will be the same as the argument, so that in many cases PRINT USR(5) 
would print a value of 5. 

Interrupts: NMI, IRQ, and BRK 

We have mentioned the mechanical aspects of interrupt Now let's look 
at how to use the interrupt for simple jobs. 

The IRQ connects through a vector in RAM; if we change the address 
within the vector, we will change the address to which the interrupt goes. 
The interrupt vector is located as follows. 

Most PET/CBM: □□qQ-DQqi (decimal 1AA~1AS) 

VIC/Commodore 64: DBI^-DBIB (decimal 7flfl-7flS) 

Before we change this vector, we should realize something quite important: 
the interrupt does a lot of work sixty times a second. It updates the clock. 
Checks the RUN/STOP key, gives service to the cassette motors, flashes 
the cursor, and handles keyboard input. If you thoughtlessly change the 
IRQ vector, it will stop doing these things; and it's hard to handle a 
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computer when it has a dead keyboard. You could try to program all these 
functions yourself; but there's an easier way. 

Suppose we use the vector to temporarily divert to our own program, and 
at the end of our program we allow the interrupt to continue with whatever 
it was going to do anyway. That way, our program would get service sixty 
times a second, and the usually interrupted jobs would still get done. 

It's not hard to do, and we can achieve many interesting effects by diverting 
the interrupt. Remember that the interrupt runs all the time, even when 
no BASIC program is runnirig By playing with the interrupt, we can make 
a permanent computer system change that is in effect even when no 
programs are in place 

Care must be taken in changing an interrupt vector. Suppose we are 
beginning to change the two-byte address; we have changed the first byte, 
and suddenly, the interrupt strikes. It will use an address that's neither 
fish nor fowl: half is the old address, and half is the new In such a case, 
It's likely that the interrupt will become confused; and if the interrupt is 
confused, the whole computer is in trouble. We must find a way to prevent 
interrupt from striking when we change the vector 

We could do this in machine language: before a routine to change the 
IRQ vector, we could give the instruction SEI (set interrupt disable). After 
this instruction is given, the IRQ cannot interrupt us. We may set the 
vector and then re-enable the interrupt with the instruction CLI (clear 
interrupt disable) Be sure that you do this, since the interrupt routine 
performs many vital functions. We may say that we have masked off the 
interrupt in the time period between execution of SEI and CLI. The NMI 
interrupt, however, is non-maskable, and SEI will have no effect on it. 

There's a second way of turning off the interrupt— that is, by shutting off 
the interrupt source Something makes an interrupt happen— it might be 
a timer, it might be an external signal, or it might even be a screen event. 
Whatever it is, we can get to the source of the interrupt and disconnect 
it. 

Almost all interrupt signals are delivered through an I A (interface adaptor) 
chip; and these chips invariably allow the path of the interrupt signal to 
be blocked temporarily. We'll discuss the I A chips later, for the moment, 
the normal interrupt signals can be blocked with the following actions: 

Commodore 64 Store $7F into address $DCDD (POKE 5t333 , IE?) 
to disable; store $fll into the same address (POKE 5^333 , lES) to 
re-enable. 
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VIC-20: Store $7F into address IRiaE (POKE 371tt , 157) to dis- 
able; store ICQ into the same address (POKE 371tt,iqa) to re- 
enable. 

PET/CBM: Store $3Cinto address $Efll3 (POKE 59^11, tD) to dis- 
able; store $3D into the same address (POKE 59^ 1 1 , 1 1) to re-enable. 

It goes without saying that the above POKEs should not normally be given 
as direct commands; the first POKE in each case will disable the keyboard 
(among other things), and you won't be able to type the restoring POKE. 

A warning about interrupt programs: changing the IRQ vector is likely to 
make it difficult to load and save programs. You may need to put the vector 
back to its original state before you attempt any of these activities. 

An Interrupt Project 

The following project is written for the Commodore 64 only. The equivalent 
coding for PET/CBM may be found in Appendix E. 

Let's write the coding for the interrupt itself. Sixty times a second, we'd 
like to copy the contents of address $91 to the top of the screen. Here 
goes: 

.A 0330 LDA $S1 
. A □33E STA $0^00 
.A a3Al JMP ($D3AD) 

Why the indirect jump? We want to "pick up" the regular interrupt routine, 
but we don't know where it is yet. When we find the address, we'll put it 
into locations $D3AD/$D3 Al so that the indirect jump will link things up 
for us. 

Now let's write the routine to enable the above interrupt coding. First, let's 
copy the interrupt address from $031^ into the indirect address at $ □ 3 A □ : 

.A 03AA LDA $031^ 

.A 03^7 STA $D3AD 

.A □3^A LDA $0315 

.A Q3AD STA $D3A1 

Now we are ready to put the address of our own interrupt routine (at 
$D3 3C) into the IRQ vector: 

.A 0350 SEI 

.A 0351 LDA #$3C 

.A 0353 STA $031^ 
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.R D35t LDR #$D3 

.k Q3S& STR $D315 

.R D35B CLI 

.R D35C RTS 

We will enable the new interrupt procedure byaSYSto$Q344, above 
(SYS fl3b). Before we give that command, let's write the coding to put 
everything back- 



. R 


D35D 


SEI 




.R 


D35E 


LDR 


$D3RQ 


.R 


D3tl 


STR 


$D314 


. R 


D3t< 


LDR 


$D3R1 


. R 


D3t7 


STR 


$D315 


. R 


D3bR 


CLI 




.R 


D3bB 


RTS 





As you can see, we put the original address back, copying it from the 
indirect address area where it was saved. 

Once this code is in place, disassembled, and checked, you may return 
to BASIC. SYS fl3b will invoke the new interrupt code; SYS flbl will 
turn it off. Note that the character (a copy of the contents of address $S 1) 
appears at the top left of the screen. The character seems to be affected 
by pressing some keys; can you establish how many keys are involved? 

Some models of Commodore 64 may print blue-on-blue when screen 
memory is POKEd, as we are doing now. If so, the character may not 
always appear in the left-hand corner. Project for enthusiasts: Fix this 
problem by storing a value into the color nybble table at address $DflDD. 

The lA Chips: PI A, VIA, and CIA 

The interface adaptor (I A) chips are richly detailed. To understand them 
fully, you'll need to read the specifications in some detail. Here, we'll give 
their main functions. 

PI A stands for peripheral interface adaptor, VIA for versatile interface 
adaptor, and CIA for complex interface adaptor. There is speculation 
among Commodore owners that the next interface chip will be called "FBI." 

The functions performed by an interface adaptor are: 

1 Event latching and interrupt contro! We have noted that these chips can be 
manipulated to block the interrupt signal In fact, they do more than "gating" 
the signal— allowing it through to the processor's IRQ trigger or alternatively 
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blocking it. They also often latch a signal into an event flag, sometimes called 
an interrupt flag. 

Latching is important A triggering event may be brief, so short, m fact, that 
the original signal causing interrupt might go away before the processor can 
look at It An I A event flag locks in the signal and holds it until the program 
turns It off. 



NEAR 'THE lA CHIPS. 



ON 



INTERRUPTING- 
EVENT 



Figure 7.2 



LATCH 



OFF 



* COMPUTER 
EVENT ACKNOWLEDGEMENT 
FLAG 



If an event has time importance — that is, if the event's timing must be ac- 
curately measured, or if the event flag must be cleared quickly so as to allow 
for the detection of a new event — we may link the event flag to the interrupt 
line If we do so, the occurrence of the event will cause the processor to be 
interrupted. We must write coding linked to the interrupt routines to detect 
this event, clear the flag, and do whatever processing is needed We set up 
this link to the interrupt line by means of a register usually called the Interrupt 
enable register. 

On the other hand, the event might not be particularly time critical. In this 
case, you can simply check the appropriate event flag from time to time. 
When the event occurs, you may then clear the flag and handle it. No interrupt 
IS needed. Even when an event flag is not connected to the interrupt, it may 
be called an interrupt flag; don't let the terminology confuse you. 

Whether or not you handle these events through interrupt sequences, it's 
important to know that it's your job to turn the event flag off. The flag will 
hold the signal until it's turned off— and it usually won't turn off unless your 
program takes some action to do this. 

The vanous flags are tnggered by timers or external signals You can read 
a flag's state by checkihg the interrupt flag register. Several flags will be 
packed together in this register; as always, you will use the logical operators— 
AND, ORA, or EOR— to extract or modify the particular flags in which you 
are interested. You may also use the IFR (interrupt flag register) to clear 
the flags 

2. Timing. Certain addresses within the I A chip are often assigned as "timers." 
These timers count down; in other words, if we place a value of $R7 into a 
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timer and look at the value immediately, we might find that it has gone down 
to $R3 Timers come in many shapes and sizes — again, check the chip 
reference for details— but most of them toggle an interrupt flag when they 
have counted down to zero. As discussed, you may choose whether or not 
this flag will really cause an interrupt signal. 

3. Input/output Certain addresses within the I A chip are connected to "ports," 
which extend outside the computer Thus, the computer can detect external 
events or control external devices Output signals are usually latching in 
nature: in other words, a store command might be taken to mean, "turn on 
port 5 and leave it on." 

Tips on lA Chips 

Many addresses within an I A chip have a different meaning, depending 
on whether they are being written to (stored) or read (loaded). Watch for 
this when you are reading the chip specifications. 

Often, the action required to turn an interrupt flag off is odd. It looks like 
the kind of thing you should do to turn the flag on. Keep in mmd that a 
flag may be turned on only by the external activity to which it is linked. 
So, although it may seem odd to turn the flag in bit zero off by storing a 
value of 1 (which would seem to want to turn bit zero on), don't worry. 
You'll get used to it. 

The lER (interrupt enable register) is often a source of problems. In many 
cases, the high bit of a value we are storing has a special meaning: if it's 
set, the other bits wilt cause the appropriate interrupt connections to turn 
on; if it's clear, the other bits will cause the appropriate interrupt connec- 
tions to be turned off. You may recall that we shut off the Commodore 64 
interrupt by storing $7F into address $DCDD. This may seem odd: we're 
stonng a binary value of $D1111111, which might seem to be turning 
bits on. In fact, the high bit of zero signals that all the remaining bits 
are"turn off" signals: so the value causes alt interrupts to be blocked. 

Infiltrating BASIC: The Wedge 

In zero-page, there's a subroutine that the BASIC interpreter uses fre- 
quently to obtain information from your BASIC program. It's used to get 
a character from your BASIC program, and to check it for type (numeric, 
end-of-command, or other). 

The routine is normally entered at either of two points; CHRGET, to get 
the next character from your BASIC program; and CHRGOT, to recheck 
the last character. The subroutine is located at$DD7Dto$DDfl7in most 
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PET/CBM computers, and at $ □ □ 7 3 to $ □ D fl A m VIC-20 or Commodore 
64. You may disassemble it there if you wish. The coding is described 
below. 

Since CHRGET is in different locations, depending on the machine, the 
following coding is shown with symbolic addresses That is, instead of 
showing the hex address value, the address is given a name, or symbol. 
Thus, CHRGOT might represent address $DD?S, CHRGOT + 1 would 
represent address $DD7A, and so on. 

CHRGET INC CHRGOT + 1 

BNE CHRGOT 

INC CHRGOT + 2 
CHRGOT LDA xxxx 

This subroutine is self-modifying, that is, it changes part of itself as it runs. 
That's not always a good programming technique, but it works well here. 

The first part of the subroutine adds one to the address used by instruction 
CHRGOT. This is a standard way of coding an address increment: add 
one to the low byte of the address; if that makes it zero, the low byte must 
have gone from $FF to $□□, in which case, add one to the high byte. 

The address loaded dy CHRGOT is within your BASIC program, or within 
the input buffer if you have just typed a direct command. Before we follow 
the next piece of code, let's look at our objectives: 

1 . If we find a space, go back and get the next character 

2. If we find a zero (BASIC end of line) or a colon (hex $3 A, BASIC end-of- 
statement), we wish to set the Z flag and exit. 

3. If we find a numeric, we wish the C flag to be clear; if we do not find a 
numeric, we wish the C flag to be set 

CHRGOT LDA xxxx 
CMP#$3A 
ECS EXIT 

If the character is a colon ($3 A), we'll leave the subroutine with the Z 
flag set. That's one of our objectives. Here's part of another one: if the 
character is $3 A or higher, it can't possibly be an ASCII numeric- 
numerics are in the range of $3 □ to $3 S. 

CMP #$5D 
BEQ CHRGET 

If the character is a space, we go back and get another character. 
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The following coding looks rather strange, but it's correct. After the two 
subtractions, the A register will be back where it started: 

SEC 

SBC #$3D 
SEC 

SBC #$DD 

After this, the A register is not changed; but the C flag will be set if the 
number is less than $3D, which means that it is not an ASCII numeric. 
Additionally, the Z flag will bet set if A contains a binary zero. We have 
met all our objectives and may now return: 

EXIT RTS 

Breaking Into BASIC 

Since BASIC comes to this subroutine often, we can infiltrate BASIC by 
changing this subroutine. Extra coding in this area is often called a "wedge" 
program. We must be very careful: 

• We must leave A, X, and Y unchanged, either we must not use them or we 
must save them away and bring them back. 

• We must not interfere with the flags. 

• We must be careful not to slow BASIC down too much. 

This is a tall order. The last requirement is often helped by two techniques: 
use the wedge to implement extra commands in direct mode only; and 
make use of a special character to identify our special commands. 

In PET/CBM, we may choose to modify this subroutine in either of two 
places: near the beginning, in CHRGET; or after the LDA, in CHRGOT. 
Each location has its advantages. In the CHRGET area, we don't need 
to preserve the A register or status flags, since CHRGOT will fix them up 
for us. In the area following CHRGOT, we have the character we wish to 
examine in the A register. 

But in either case, it's an exacting job. 

VIC-20 and Commodore 64 have made the job much more easy by pro- 
viding a vector at address $D3Dfl/$D3DS that will give us control of the 
computer, if we wish, immediately before each BASIC command is exe- 
cuted. We still need to use due care, but we have much more latitude. 

The address of the instruction at C H R G T is often referred to as T X T P T R , 
the text pointer. This address always points to the BASIC command being 
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executed at the moment. If we want to participate in reading BASIC, we 
must learn to use TXTPTR to get the information— usually by means of 
indirect, indexed addressing— and to leave this address pointing at a suit- 
able place when we return control back to the normal BASIC handling 
programs. 

Project: Adding a Connnnand 

LeVs add a simple command to the M\C and Commodore 64 by using the 
$030 a vector. The ampersand (&) character isn't used in most BASIC 
programs, so Nwe'W make it mean this: whenever you see the code , 
print ten asterisk (*) characters to the computer screen, followed by a 
carnage vetuvn. 

As with our interrupt program, we'll copy the old address from $D3Dfl/ 
□ 3 OS into an indirect address location, so that we can link up with the 
normal computer routines as necessary. 

An important poinf the vector will give us control, if we want it, with 
TXTPTR positioned immediately before the next instruction. When we 
return control to BASIC, we must be sure that TXTPTR is similarly po- 
sitioned. 

Here's our instruction "intercept": 
.A 0330 LDY #$□! 

We're going to use indirect, indexed addressing to "look ahead" at the 
instruction. Let's look, using TXTPTR as an indirect address: 

.A □33E LDA ($7A) , Y 

Since Y equals one, we'll look just beyond the address to which TXTPTR 
is pointing: 

.A U3A0 CMP 

.A 03^5 BEQ $Q3A7 

.A JMP ($D3AD) 

If the character is an ampersand, we'll branch ahead to $03^7. If not, 
we'll connect through the indirect vector to the regular BASIC interpreter 
code: 

.A □3^7 JSR $0073 

We may call CHRGET to move the pointer along. Now TXTPTR points 
squarely at the ampersand character. We are ready to print ten asterisks: 
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.A 




LDY 


#$□□ 


.A 




LDA 


#$EA 


.A 




JSR 


$FFDE 


. A 


□ 351 


INY 




. A 


□ 35E 


CPY 


#$DA 


.A 


nisA 


BCC 


$Q3AE 


.A 


□ 35b 


LDA 


#$DD 


.A 


□ 35fl 


JSR 


$FFD5 


.A 


□ 35B 


JMP 


$Q3AA 



The above code prints an asterisk ($EA) ten times and then prints a 
RETURN ($DD). It then goes to the regular BASIC interpreter, which will 
look behind the ampersand character for a new BASIC command. 

Now we need to set up the link to our program. We'll write the code to do 
this starting at $D35E, so that SYS flbE will put the new command 
(ampersand) into effect: 



.A 


□ 35E 


LDA 


$a3aa 


.A 


□ 3bl 


STA 


SDBAD 


. A 


nihA 


LDA 


$D3DR 


. A 


□ 3b7 


STA 


$a3Al 


.A 


□ 3bA 


LDA 


#$3C 


. A 


□ 3bC 


STA 


$D3Dfl 


. A 


□ 3bF 


LDA 


#$□3 


.A 


□ 371 


STA 


$D3DR 


. A 


□ 37^ 


RTS 





When you have completed and checked the code (remember this is for 
VIC and Commodore 64 only), return to BASIC. Type NEW and write the 
following program: 

ID □ PRINT 3 ^ :&: PRINT 5 + b 
IID & 

lED PRINT »»THAT» S ALL" 

If you type RUN, you will get a SYNTAX ERROR in line IDD. We have 
not yet implemented our "ampersand" command. Type the command SYS 
flbE. Now type RUN again. The ampersand command obediently prints 
ten asterisks each time it is invoked. 

Infiltrating BASIC isn't an easy job. But it can be done. 

Things You Have Learned 

—The stack is located in page 1, from $01FF moving down to $01 00. It is 
used for holding temporary information. A program may push information to 
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the stack, and then pull it back later The last item that has been pushed onto 
the stack will be the first item to be pulled back off 

— Great care must be taken to ensure that your program pulls exactly the same 
number of items back from the stack as it pushed In particular, be sure that 
a branch or jump does not inadvenemly omit a needed stack activity. A badly 
handled stack is often fatal to the program run 

— PHR pushes th6 contents of A to the stack; PLR pulls from the stack into 
the A register. These two commands are often used to temporanly save A. 
PHP pushes the status register (S R); P L A pulls it back. These two commands 
are often used for "deferred decisions," 

— JSR pushes a return address (minus 1) to the stack; RTS recalls this ad- 
dress. We may use JSR and RTS without needing to know the role the stack 
plays, since the two commands take care of the details for us. 

—Interrupts, including the BRK instruction, push three items to the stack; RTI 
brings them back so that the interrupted program may resume 

—USR IS a function, as opposed to SYS, which is a command. USR goes to 
a preset address, takes a numenc argument, and can return a value. In 
practice, USR and SYS are used in quite similar ways. 

— Commodore ROM systems contain coding for the interrupt sequences that 
cause the data registers— A, X, and Y— to be pushed to the stack, and a 
branch to be taken through an indirect address that the user can modify. 
Since interrupt is active virtually all the time, it may be used to create activities 
that are active even when no BASIC program ts running. 

—The various I A chips — PI A, VIA, and CIA — perform many different func- 
tions, including: recording events in latching flags and controlling interrupts, 
timing; and connecting input/output ports. The detailed specification sheets 
must be studied for these rather complex details, 

—A subroutine called CHRGET is used frequently by the BASIC interpreter 
when a BASIC program is running. We may modify or add to this subroutine 
in order to add to or modify the BASIC language itself 

Questions and Projects 

If you redirect the interrupt vector to your own machine language program, 
you can copy all of zero page to the screen. Use indexing; start X at zero; 
and walk through the whole of zero page, loading the memory contents 
and storing (indexed again, of course) to the screen. Don't forget to connect 
up your code to the regular interrupt entry address. 

You'll get a fascinating screen. There will be timers going, and as you 
type on the keyboard you'll see various inner values changing around. 
Enjoy the view. 

It's sometimes suggested that a good way to pass information to a sub- 
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routine is to push the information onto the stack and call the subroutine. 
The subroutine can pull the information from the stack. What's wrong with 
this suggestion? 

The above suggestion can be implemented, but it takes a lot of careful 
stack work. You might like to work through the logic needed to do this. 

There are some utility programs which, when placed in the computer, 
allow a listing to be "scrolled." In other words, if the screen shows BASIC 
lines E 5 □ to ^ b □ , the user can take the cursor to the bottom of the screen 
and continue to press the cursor-down key. New BASIC lines (following 
AhiO) will then appear. This is not an easy thing to code, but here's the 
question: do you think that this feature is done with a SYS command, a 
wedge, or an interrupt technique? Why? 

A SYS command from BASIC is like a subroutine call; so it must place 
an address on the stack to allow RTS to return to BASIC. Take a look at 
the stack and see if you can determine what address is used to return to 
BASIC on your machine. 
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Timing, 
Input/Output, 

and 

Conclusion 

This chapter discusses: 

• How to estimate the speed of your program 

• Input and output from tape, disk, and printer 

• Review of instructions 

• Debugging 

• Symbolic assemblers 

• Where to go from here 
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Timing 

For many applications, machine language programs seem to run instan- 
taneously. The speed of the 650x is much greater than that of other 
devices, including the human user. The machine language program usually 
ends up waiting for something: waiting for the keyboard, waiting for the 
printer, waiting for the disk, or waiting for the human to read and react to 
information presented on the screen. 

Occasionally, it may be important to get fairly precise timing for a machine 
language program. If so, the following rules of thumb may be kept in mind: 

— All timing estimates are crude if the interrupt routines are still active. The 
effect of interrupt on timing can be crudely estimated by adding 10 percent 
to the running time. 

— Remember to allow for loops. If an instruction within a loop is repeated ten 
times, its timing will need to be counted ten times. 

— The "clock speed," or memory cycle speed, of most Commodore machines 
is roughly 1 microsecond — one millionth of a second. The precise number 
varies from one machine to another, and also vanes between North America 
and other regions. 

— Most instructions run at the fastest imaginable speed. Count the memory 
cycles, and that's how fast the instruction will execute. For example, 
LDA #$DD will need two memory cycles just to get the instruction — and 
that's how fast It runs LDA $D5DD , X will usually take four memory cycles, 
three to get the instruction, and one to fetch the data from page 5 Exceptions- 
no instruction runs in less than two cycles; and shift/rotate instructions, INC/ 
DEC, and JSR/RTS take longer than you might expect by this rule. 

—Branches time differently, depending on whether the branch is taken (three 
cycles) or not taken (two cycles) 

— When a page boundary is crossed, the computer needs an extra cycle to do 
the arithmetic. If the program branches from $DFE4 to $1DE3, there will 
be an extra cycle; if we LDA $E^E7 , Y, there will be an extra cycle if Y 
contains a value of $ IS or greater. 

Detailed timing values can be obtained from most tables of instructions. 

Let's take a simple routine and estimate its timing. The following program 
logically fiNDs the contents of !□□ locations from $17EDto$lfl<<: 

□33C LDX #$□□ 

□33E LDfi #$□□ 

D3^D AND $17ED,X 

D3A3 INX 
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s repeated ten 



□3^5 CPX 

03^7 BCC $03^0 

□3^R RTS 

We may work out timing as follows* 

LDX #$□□— executed once* 2 

LDA #$□□— executed once- 2 

AND $17ED,X: 32 times at 4 cycles 128 

68 times at 5 cycles (page cross) 340 

I NX— 100 times at 2 cycles 200 

CPX 100 times at 2 cycles. 200 

BCC— 99 times at 3 cycles 297 

1 time at 2 cycles (no branch) 2 

RTS— 6 cycles. * 6 

Total time: 117 1 cycles, or slightly over one thousandth of a second. We 
might add 10 percent to allow for the effects of interrupt; and since this is 
a subroutine, we could also add the extra six cycles needed to perform 
the JSR. 

Where timing is critical, the interrupt could be locked out with SEI Be 
careful: it's seldom necessary, and is potentially dangerous. 



Input and Output 



We know that calling the kernat routine CHROOT at $FFD2 will send an 
ASCII character to the screen. We may also redirect output to any logical 
file. 

We have seen that we may obtain input from the keyboard buffer into the 
A register by calling kernal routine GETIN at $FFE^. We may also 
redirect the input so that we draw information from any logical file. 

The same commands— $FFDE and $FFE^— stilt perform the input and 
output. But we "switch" either of them to connect to a chosen device — or 
more accurately, a chosen logical file. The file must be open; we may 
switch to the file, and then switch back to normal I/O as we wish. 



Switching Output 



We use subroutine CHKOOT at address $FFCR to switch output to a 
logical file. When we want to restore output to the screen, we call sub- 
routine CLRCHN at $FFCC. This is not the same as an OPEN and 
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KEYBOARD 




INPUT 



OUTPUT 



PROGRAM 



SCREEN 




INPUT 
DEVICES 



OUTPUT 
DEVICES 



CHKIN ($FFC6) 

SETS THE 
INPUT SWITCH 



CHKOUT ($FFC9) 

SETS THE 
OUTPUT SWITCH 



CLRCHN ($FFCC) 
RESTORES BOTH 
SWITCHES TO "NORMAL 



1 1 



Figure 8.1 

CLOSE — we simply connect to the file and disconnect, and we can do 
this as many times as we w^nt. 

Subroutine: CHKOUT 



The character subsequently sent by $FFD2 is usually ASCII (or PET 
ASCII). When sent to the pnnter, special characters— text/graphics, 
width— will be honored in the usual way. Similarly, disk commands can 
be transmitted over secondary address 15 if desired; a logical "com- 
mand channel" file must be previously opened. 

Registers: Registers fi and X will be changed dunng the CHKOOT 
call. Be sure to save any sensitive data in these registers before calling 
CHKOOT. 

Status: Status flags may be changed. In VIC and Commodore 64, the 
C (carry) flag indicates some type of problem with connecting to the 
output channel. 



To switch output to logical file 1, we would need to follow these steps: 



Address 
Action. 



Switches the output path (used byCHROUT, SPFDE) 
so that output is directed to the logical file specified in the 
X register. The logical file must previously have been 
opened. 



$FFCH 
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1 Load a value of 1 into X (LDX #$□!) 
2. JSR to address $FFCS. 

Once the output is switched, we may send as many characters as we 
wish using subroutine $FFDE. Eventually, we must disconnect from the 
logical file and return to our default output, the screen. We do this by 
calling subroutine CLRCHN at address $FFCC. 



Subroutine. CLRCHN 
Address: $FFCC 

Action: Disconnects input and output from any logical files and 

restores them to the "default" input and output channels, 
keyboard and screen. The logical files are not closed, and 
may be reconnected at a later time. 

Registers: Registers A and X will be changed during the CLRCHN 
call. Be sure to save any sensitive data in these registers. 

Status: Status flags may be changed. In VIC and Commodore 64, the 
C (carry) flag indicates some type of problem with output. 



The logical file concept is important. I may send to any destination — 
cassette, printer, disk, or screen — without knowing which device is in- 
volved. I send the characters on their way and the operating system sees 
that they are delivered wherever they need to go. 

This simplifies the machine language programmer's job. It's a simple task 
to send the characters to some logical channel; the programmer does not 
need to take special coding action depending on which device is involved. 

Output Example 

If we wanted to print the message HI on the printer, we might code as 
follows. 

First, we'll open the printer channel in BASIC. Let's use logical file num- 
ber 1: 

!□□ OPEN 1,^ 
IID SYS flSfl 
lED CLOSE 1 

If you don't have a printer, you may open the file to cassette (OPEN 
1 , 1 , E) or to disk (OPEN 1 / fl / 3 , DEMO / S , W»»)- The machine 
language program won't care: it will send to logical file number 1 no matter 
what it is; it might even be the screen (OPEN 1 , 3). Let's write the coding: 
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.a DBBC LDX #$□! 
.a D33E JSR $FFCq 

Now the output is connected to logical file 1. Let's say HI: 



.a 


□ 341 


LDa 


#$4fl 


.a 


□ 343 


JSR 


$FFD2 


.a 


□ 34t 


LDa 


#$4q 


.a 


□ 34fl 


JSR 


$FFDE 


.a 


□ 34B 


LDa 


#$□0 


.a 


□ 34D 


JSR 


$FFDE 


.a 


□ 350 


JSR 


$FFCC 


.a 


□ 353 


RTS 





Don't forget to send the RETURN — the printer needs it. After the machine 
language program says HI, the program will return to BASIC and close 
the file. Notice that the machine language program doesn't care what it's 
saying HI to ... it sends the data to logical file 1. 

Switching Input 

We use subroutine CHKIN at address $FFCfc to switch input so as to 
draw data from a logical file. When we want to restore input from the 
keyboard, we call subroutine CLRCHN at $FFCC. Again, this is not the 
same as an OPEN and CLOSE — we simply connect to the file and dis- 
connect, and we can do this as many times as we want. 



Subroutine CHKIN 
Address SFFCt 

Action. Switches the input path (used Dy GET, SFFE^) so that input is 

taken from the logical file specified in the X register The logical 
file nnust previously have been opened 

The character subsequently obtained by $FFE^ into the A register is usually 
ASCII (or PET ASCII) A binary zero received from a file usually represents exactly 
that: an input character whose value is CHR$(D), this is different from keyboard 
GET where a binary zero means "no key pressed " When accessing a file, ST 
(address $SD for VIC and Commodore 64, $SL for most PET/CBM) is used 
for Its usual functions of signalling end-of-file or error. Similarly, disk status in- 
formation can be received over secondary address 1 5 if desired, a logical "com- 
mand channel" file must be previously opened. 

Registers; Registers A and X will be changed during the CHKIN call Be sure 
to save any sensitive data in these registers before calling CHKIN. 

Status. Status flags may be changed. In VIC and Comnnodore 64, the C (carry) 
flag indicates some type of problem with connecting to the input channel. 



To switch input to logical file 1, we would need to follow these steps: 
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—Load a value of 1 into X (LDX #$□!) 
— JSR to address $FFCt. 

Once the input is switched, we may obtain as many characters as we wish 
using subroutine $FFE < . Eventually, we must disconnect from the logical 
file and return to our default input — the keyboard. We do this by calling 
subroutine CLRCHN at address $FFCC.This is the same subroutine that 
disconnects output from a logical file. 

Input Example 

We can write a program to read an input file from disk or cassette. First, 
let's write the file. We open the file according to its type: 

Disk OPEN l,fl,3, "DzDEMO/SrW" 

Cassette: OPEN 1,1,1 

This may be done with a direct statement. Now let's write a few things to 
the file: 

PRINT#1/ "HELLO THIS IS A TEST" 
PRINT#1/ "THIS IS THE LAST LINE" 
CLOSE 1 

If we have typed in the above statements correctly, we should have a 
completed sequential file written on cassette or disk. Before writing the 
machine language input program, let's examine how we nnight read the 
file back in BASIC: 

Disk' IDD OPEN l,fi,3, "DEMO" 

Cassette: IDD OPEN 1 

IID INPUT #1,X$ 

lED PRINT X$ 

13D IF ST = D GOTO IID 

l^D CLOSE 1 

We might alternatively have written lines 11 □ and 12D as 

IID GET #1/X$ 
lED PRINT X$; 

This more closely approximates the logic flow of our machine language 
program, since it will get the characters one at a time. If you are unsure 
about the role of ST, read up on it. We will use the same variable (at its 
address of $ R □ or $ R fc) to do exactly the sanne thing in machine language. 

Type NEW and enter the following program: 
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Disk !□□ OPEN l,fl,3, "DEMO" 

Cassette: !□□ OPEN 1 

IID SYS fiEfi 

lED CLOSE 1 

We will read the file and copy it to the screen entirely in machine language. 
Let's start coding at $D33C : 

.A D33C LDX #$□! 
.fi DBBE JSR $FFCfc 

Now the input is connected to logical file 1. Let's get information from it 
and put it on the screen: 

.fi 03^1 JSR $FFE< 
.fi D3^^ JSR $FFDE 

We must check ST as we would in BASIC. ST might be at either of two 
addresses, depending on the system: 

VIC, Commodore 64. .AD347LDA$SD 
CBM/PET .A 03^7 LDA $SL 

If ST is zero, there is more to come from the file; we may go back. If ST 
is nonzero, there could be an error or we may be at the end of the file. In 
either case, we don't want to read more from the file. 

.fi DB^q BEQ $D3<1 
.fi D3AB JSR $FFCC 
.A D3AE RTS 

Check It and try it. The file is delivered to the screen quickly. 

A File Transfer Program 

Let's write a program to transfer a sequential file from any common device 
to any other. BASIC will sort out which files to handle; once the files are 
opened, machine language will take from and deliver to the appropriate 
logical devices as desired 

It's not a good idea to switch input and output at the same time — in other 
words, to call both $FFCfc and $FFCR without canceling either via $FFCC. 
The kernal doesn't mind, but it confuses the peripheral devices, which 
expect to have exclusive occupancy of the data bus to the computer. So 
we'll follow the pattern: switching on, sending or receiving, switching off, 
and then going to the other device. 
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One more thing. S T tells us the status of the last device handled. Consider: 
if we input a character, then output a character, and then checl< the value 
of ST. we have a problem. ST will not tell us about the input, since the 
last device handled was output; thus, we won't know if we are at the end 
of the file or not. In machine language, as in BASIC, we must code carefully 
to solve this problem. 

Here comes BASIC: 

100 PRINT "FILE TRfiNSFER" 

IID INPUT "INPDT FROM (DISK, TfiPE) " ; fi$ 

120 IF LEFT$(fi$,l) = "T" THEN OPEN 1:G0T0 IfcD 

13D IF LEFT$(fi$,l)<> "D" GOTO IID 

!<□ INPUT "DISK FILE NAME" ; N$ 

15D OPEN l,fl,3,N$ 

ItD INPUT "TO (DISK, TfiPE, SCREEN) " ;B$ 

17 □ IF LEFTS ( B$,l) = "S" THEN OPEN 2, 3: GOTO 24 □ 

IflD IF LEFT$(B$,1) = "D" GOTO 21D 

iqO IF LEFT$(B$,1) <> "T" GOTO IfcD 

200 IF LEFT$(fi$,l) ="T" GOTO IfcD 

21D INPUT "OUTPUT FILE NAME" ;F$ 

IF LEFT$(B$, 1) ="D" 
THEN OPEN 2,fl,4,"D:" + N$ + ",S,W" 
23D IF LEFT$(B$,1) ="T" THEN OPEN 2,1,1,N$ 
E40 SYS xxxx 
E50 CLOSE E:CLOSE 1 

We'll work this out for the Commodore 64 computer; you can adjust it for 
PET/CBM or VIC-20. The above BASIC program should not take up more 
than 511 bytes; on a standard Commodore 64, that means that we'll have 
clear space for our machine language program starting at $DADD (dec- 
imal 55t0). We'll move the start-of-variables along, of course, so that 
our machine language program won't be disturbed by them. 

When we first type line E<D, we won't know what SYS address to use. 
After the program is typed in (with SYS xxxx at line E<D), we can easily 
confirm that the machine language can start at $DADD by checking the 
start-of-variables pointer. We go back and change E<D to SYS ESfcD; 
now we're ready to put in the machine language code: 

.fi OfiOO LDX #$□! 
.fi OfiOS JSR $FFCfc 
•fi OfiOS JSR $FFE4 

By this time, we have a character in the A register from the input source. 
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We also have a value in ST, telling us if this is the last character. Let's 
examine the ST problem: we must check its value now, since ST will be 
changed after we do the output. But we don't want to take any action 
based on S T yet; we must first send the character we have received. Let's 
check ST, and put the results of the check onto the stack: 

-fi DfiDfl LDX $RD 
.fi DfiDfi PHP 

If ST IS zero, the Z flag will be set; we'll preserve this flag along with the 
others until we call it back from the stack. If you are adapting this program 
for the PET/CBM, don't forget that S T is at address $ R fc for your machine. 

The next thing we want to do is to disconnect the input by calling $FFCC; 
but this will destroy the A register. How can we preserve this value? By 
transferring to another register, or by pushing A to the stack. Let's do that. 
There will now be two things on the stack. 

.A DADB PHfi 

We are now free to disconnect from the input channel and connect to the 
output. Here we go: 



.a 


□aoc 


JSR 


$FFCC 


.a 


oaoF 


LDX 


#$DE 


.a 


oaii 


JSR 


$FFCR 


.a 


oai< 


PLa 





The A register gets back the last thing saved to the stack, and that, of 
course, is our input character. We're ready to send it to the output device: 

,A DfilS JSR $FFD2 
.A Dfilfl JSR $FFCC 

Now we may pick up on the condition of ST that we stacked away earlier. 
Here come the flags that we stored: 

.A DfilB PLP 

If the Z flag is set, we want to go back and get another character. If not, 
we're finished and can return to BASIC, allowing BASIC to close the files 
for us: 

.A DfilC BEQ $□&□□ 
.A DAIE RTS 

Important: Before running this program, be sure to move the start-of- 
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Timing, 
Input/Output, 

and 

Conclusion 

This chapter discusses: 

• How to estimate the speed of your program 

• Input and output from tape, disk, and printer 

• Review of instructions 

• Debugging 

• Symbolic assemblers 

• Where to go from here 
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Timing 



For many applications, machine language programs seem to run instan- 
taneously. The speed of the 650x is much greater than that of other 
devices, including the human user. The machine language program usually 
ends up waiting for something: waiting for the keyboard, waiting for the 
printer, waiting for the disk, or waiting for the human to read and react to 
information presented on the screen. 

Occasionally, it may be important to get fairly precise timing for a machine 
language program. If so, the following rules of thumb may be kept in mind: 

—All timing estimates are crude if the interrupt routines are still active. The 
effect of interrupt on timing can be crudely estimated by adding 10 percent 
to the running time. 

—Remember to allow for loops. If an instruction within a loop is repeated ten 
times, its timing will need to be counted ten times. 

— The "clock speed," or memory cycle speed, of most Commodore machines 
is roughly 1 microsecond — one millionth of a second. The precise number 
varies from one machine to another, and also vanes between North America 
and other regions. 

—Most instructions run at the fastest imaginable speed. Count the memory 
cycles, and that's how fast the instruction will execute. For example, 
LDA #$DD will need two memory cycles just to get the instruction — and 
that's how fast It runs LDA $D5DD , X will usually take four memory cycles, 
three to get the instruction, and one to fetch the data from page 5 Exceptions- 
no instruction runs in less than two cycles; and shift/rotate instructions, INC/ 
DEC, and JSR/RTS take longer than you might expect by this rule. 

—Branches time differently, depending on whether the branch is taken (three 
cycles) or not taken (two cycles) 

— When a page boundary is crossed, the computer needs an extra cycle to do 
the arithmetic. If the program branches from $DFE4 to $1DE3, there will 
be an extra cycle; if we LDA $E^E7 , Y, there will be an extra cycle if Y 
contains a value of $ IS or greater. 

Detailed timing values can be obtained from most tables of instructions. 

Let's take a simple routine and estimate its timing. The following program 
logically fiNDs the contents of !□□ locations from $17EDto$lfl<<: 



□ 33C 

□ 33E 

D3A3 



LDX #$□□ 

LDfi #$□□ 

AND $17ED,X 
INX 
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□3^5 CPX 

03^7 BCC $D3^D 

□3^R RTS 



We may work out timing as follows* 

LDX #$□□— executed once* 
LDA #$□□— executed once- 
AND $17ED,X: 32 times at 4 cycles 



128 



2 



2 



68 times at 5 cycles (page cross) 
I NX— 100 times at 2 cycles 
CPX 100 times at 2 cycles. 

BCC— 99 times at 3 cycles 



200 
297 



340 



200 



1 time at 2 cycles (no branch) 
RTS— 6 cycles. 



6 



2 



Total time: 117 1 cycles, or slightly over one thousandth of a second. We 
might add 10 percent to allow for the effects of interrupt; and since this is 
a subroutine, we could also add the extra six cycles needed to perform 
the JSR. 

Where timing is critical, the interrupt could be locked out with SEI Be 
careful: it's seldom necessary, and is potentially dangerous. 



We know that calling the kernat routine CHROOT at $FFD2 will send an 
ASCII character to the screen. We may also redirect output to any logical 



We have seen that we may obtain input from the keyboard buffer into the 
A register by calling kernal routine GETIN at $FFE^. We may also 
redirect the input so that we draw information from any logical file. 

The same commands— $FFDE and $FFE^— stilt perform the input and 
output. But we "switch" either of them to connect to a chosen device — or 
more accurately, a chosen logical file. The file must be open; we may 
switch to the file, and then switch back to normal I/O as we wish. 



We use subroutine CHKOOT at address $FFCR to switch output to a 
logical file. When we want to restore output to the screen, we call sub- 
routine CLRCHN at $FFCC. This is not the same as an OPEN and 



Input and Output 



file. 



Switching Output 
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KEYBOARD 




INPUT 



OUTPUT 



PROGRAM 



SCREEN 





INPUT 
DEVICES 



OUTPUT 
DEVICES 



CHKIN ($FFC6) 

SETS THE 
INPUT SWITCH 



CHKOUT ($FFC9) 

SETS THE 
OUTPUT SWITCH 



CLRCHN ($FFCC) 
RESTORES BOTH 
SWITCHES TO "NORMAL' 



1 1 



Figure 8.1 

CLOSE — we simply connect to the file and disconnect, and we can do 
this as many times as we w^nt. 

Subroutine: CHKOUT 



The character subsequently sent by $FFD2 is usually ASCII (or PET 
ASCII). When sent to the pnnter, special characters — ^text/graphics, 
width — will be honored in the usual way. Similarly, disk commands can 
be transmitted over secondary address 15 if desired; a logical "com- 
mand channel" file must be previously opened. 

Registers: Registers fi and X will be changed dunng the CHKOOT 
call. Be sure to save any sensitive data in these registers before calling 
CHKOOT. 

Status: Status flags may be changed. In VIC and Commodore 64, the 
C (carry) flag indicates some type of problem with connecting to the 
output channel. 



To switch output to logical file 1, we would need to follow these steps: 



Address 
Action. 



Switches the output path (used byCHROUT, SPFDE) 
so that output is directed to the logical file specified in the 
X register. The logical file must previously have been 
opened. 



$FFCH 
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1 Load a value of 1 into X (LDX #$□!) 
2. JSR to address $FFCS. 

Once the output is switched, we may send as many characters as we 
wish using subroutine $FFDE. Eventually, we must disconnect from the 
logical file and return to our default output, the screen. We do this by 
calling subroutine CLRCHN at address $FFCC. 



Subroutine. CLRCHN 
Address: $FFCC 

Action: Disconnects input and output from any logical files and 

restores them to the "default" input and output channels, 
keyboard and screen. The logical files are not closed, and 
may be reconnected at a later time. 

Registers: Registers A and X will be changed during the CLRCHN 
call. Be sure to save any sensitive data in these registers. 

Status: Status flags may be changed. In VIC and Commodore 64, the 
C (carry) flag indicates some type of problem with output. 



The logical file concept is important. I may send to any destination — 
cassette, printer, disk, or screen — without knowing which device is in- 
volved. I send the characters on their way and the operating system sees 
that they are delivered wherever they need to go. 

This simplifies the machine language programmer's job. It's a simple task 
to send the characters to some logical channel; the programmer does not 
need to take special coding action depending on which device is involved. 

Output Example 

If we wanted to print the message HI on the printer, we might code as 
follows. 

First, we'll open the printer channel in BASIC. Let's use logical file num- 
ber 1: 

!□□ OPEN 1,^ 
IID SYS flSfl 
lED CLOSE 1 

If you don't have a printer, you may open the file to cassette (OPEN 
1 , 1 , E) or to disk (OPEN 1 / fl / 3 , DEMO / S , W»»)- The machine 
language program won't care: it will send to logical file number 1 no matter 
what it is; it might even be the screen (OPEN 1 , 3). Let's write the coding: 



736 



MACHINE LANGUAGE FOR COMMODORE MACHINES 



.A DBBC LDX #$□! 
.A Q33E JSR $FFCq 

Now the output is connected to logical file 1. Let's say HI: 



.A 


□ 341 


LDA 


#$4fi 


. A 


□ 343 


JSR 


$FFD2 


.A 


□ 34t 


LDfi 




.A 




JSR 


$FFD5 


.A 


Q3AB 


LDfi 


#$0D 


.A 


□ 34D 


JSR 


$FFD5 


.A 


□ 35^ 


JSR 


$FFCC 


.A 


□ 353 


RTS 





Don't forget to send the RETURN— the printer needs it. After the machine 
language program says HI, the program will return to BASIC and close 
the file. Notice that the machine language program doesn't care what it's 
saying HI to ... it sends the data to logical file 1. 

Switching Input 

We use subroutine CHKIN at address $FFCfc to switch input so as to 
draw data from a logical file. When we want to restore input from the 
keyboard, we call subroutine CLRCHN at $FFCC. Again, this is not the 
same as an OPEN and CLOSE — we simply connect to the file and dis- 
connect, and we can do this as many times as we want. 



Subroutine CHKIN 
Address SFFCt 

Action. Switches the input path (used Dy GET, SFFE^) so that input is 

taken from the logical file specified in the X register The logical 
file must previously have been opened 

The character subsequently obtained by $FFE^ into the A register is usually 
ASCII (or PET ASCII) A binary zero received from a file usually represents exactly 
that: an input character whose value is CHR$(D), this is different from keyboard 
GET where a binary zero means "no key pressed " When accessing a file, ST 
(address $SD for VIC and Commodore 64, $SL for most PET/CBM) is used 
for Its usual functions of signalling end-of-file or error. Similarly, disk status in- 
formation can be received over secondary address 1 5 if desired, a logical "com- 
mand channel" file must be previously opened. 

Registers; Registers A and X will be changed during the CHKIN call Be sure 
to save any sensitive data in these registers before calling CHKIN. 

Status. Status flags may be changed. In VIC and Comnnodore 64, the C (carry) 
flag indicates some type of problem with connecting to the input channel. 



To switch input to logical file 1, we would need to follow these steps: 
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—Load a value of 1 into X (LDX #$□!) 
— JSR to address $FFCL 

Once the input is switched, we may obtain as many characters as we wish 
using subroutine $FFE< . Eventually, we must disconnect from the logical 
file and return to our default input — the keyboard. We do this by calling 
subroutine CLRCHN at address $FFCC. This is the same subroutine that 
disconnects output from a logical file. 

Input Example 

We can write a program to read an input file from disk or cassette. First, 
let's write the file. We open the file according to its type: 

Disk OPEN l,fl,3, "DzDEMO/SrW" 

Cassette: OPEN 1,1,1 

This may be done with a direct statement. Now let's write a few things to 
the file: 

PRINT#1/ "HELLO THIS IS A TEST" 
PRINT#1/ "THIS IS THE LAST LINE" 
CLOSE 1 

If we have typed in the above statements correctly, we should have a 
completed sequential file written on cassette or disk. Before writing the 
machine language input program, let's examine how we nnlght read the 
file back in BASIC: 

Disk' IDD OPEN l,fi,3, "DEMO" 

Cassette: IDD OPEN 1 

IID INPUT #1,X$ 

lED PRINT X$ 

13D IF ST = D GOTO IID 

l^D CLOSE 1 

We might alternatively have written lines 11 □ and 12D as 

IID GET #1/X$ 
lED PRINT X$; 

This more closely approximates the logic flow of our machine language 
program, since it will get the characters one at a time. If you are unsure 
about the role of ST, read up on it. We will use the same variable (at its 
address of $ R □ or $ R fc) to do exactly the sanne thing in machine language. 

Type NEW and enter the following program: 
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Disk !□□ OPEN l,fl,3, "DEMO" 

Cassette: !□□ OPEN 1 

IID SYS fiEfi 

lED CLOSE 1 

We will read the file and copy it to the screen entirely in machine language. 
Let's start coding at $D33C : 

.fi 033C LDX #$□! 
.fi DBBE JSR $FFCfc 

Now the input is connected to logical file 1. Let's get information from it 
and put it on the screen: 

.fi 03^1 JSR $FFE< 
.fi 03^^ JSR $FFDE 

We must check ST as we would in BASIC. ST might be at either of two 
addresses, depending on the system: 

VIC, Commodore 64. .A U3A7 LDA $RD 
CBM/PET .A 03^7 LDA $SL 

If ST is zero, there is more to come from the file; we may go back. If ST 
is nonzero, there could be an error or we may be at the end of the file. In 
either case, we don't want to read more from the file. 

.a DB^q BEQ $D3<1 
.a D3AB JSR $FFCC 
.A D3AE RTS 

Check It and try it. The file is delivered to the screen quickly. 

A File Transfer Program 

Let's write a program to transfer a sequential file from any common device 
to any other. BASIC will sort out which files to handle; once the files are 
opened, machine language will take from and deliver to the appropriate 
logical devices as desired 

It's not a good idea to switch input and output at the same time — in other 
words, to call both $FFCfc and $FFCR without canceling either via $FFCC. 
The kernal doesn't mind, but it confuses the peripheral devices, which 
expect to have exclusive occupancy of the data bus to the computer. So 
we'll follow the pattern: switching on, sending or receiving, switching off, 
and then going to the other device. 
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One more thing. S T tells us the status of the last device handled. Consider: 
if we input a character, then output a character, and then checl< the value 
of ST. we have a problem. ST will not tell us about the input, since the 
last device handled was output; thus, we won't know if we are at the end 
of the file or not. In machine language, as in BASIC, we must code carefully 
to solve this problem. 

Here comes BASIC: 

!□□ PRINT "FILE TRANSFER" 

11 □ INPDT "INPUT FROM (DISK, TAPE) " ; fi$ 

12D IF LEFT$(a$,l) = "T" THEN OPEN 1:G0T0 IfcD 

13D IF LEFT$(a$,l)<> "D" GOTO IID 

KD INPDT "DISK FILE NaME";N$ 

15D OPEN l,a,3,N$ 

IfcD INPDT "TO (DISK, TAPE, SCREEN)";B$ 

17 □ IF LEFTS ( B$,l) = "S" THEN OPEN 2, 3: GOTO 24 □ 

IflD IF LEFT$(B$,1) = "D" GOTO 21D 

IRQ IF LEFT$(B$,1) <> "T" GOTO IfcD 

5DD IF LEFTS (fi$,l) = "T" GOTO ItO 

21U INPUT "OUTPUT FILE NAME" ;F$ 

IF LEFT$(B$,1) = "D" 
THEN OPEN 2,a,4,"0:" + N$ + ",S,W" 
23 □ IF LEFT$(B$,1) = "T" THEN OPEN 2,1,1,N$ 

SYS xxxx 
25D CLOSE 2: CLOSE 1 

We'll work this out for the Commodore 64 computer; you can adjust it for 
PET/CBM or VIC-20. The above BASIC progrann should not take up more 
than 511 bytes; on a standard Commodore 64, that means that we'll have 
clear space for our machine language program starting at $DADD (dec- 
imal ESfcD). We'll move the start-of-variables along, of course, so that 
our machine language program won't be disturbed by them. 

When we first type line 2AD, we won't know what SYS address to use. 
After the program is typed in (with SYS xxxx at line 2<D), wecan easily 
confirm that the machine language can start at $DADD by checking the 
start-of-variables pointer. We go back and change 2<D to SYS 25fcD; 
now we're ready to put in the machine language code: 

•A DADD LDX #$01 
.A UAUE JSR $FFCt 
.A DADS JSR $FFE4 

By this time, we have a character in the A register from the input source. 



740 



MACHINE LANGUAGE FOR COMMODORE MACHINES 



We also have a value in ST, telling us if this is the last character. Let's 
examine the ST problem: we must check its value now, since ST will be 
changed after we do the output. But we don't want to take any action 
based on S T yet; we must first send the character we have received. Let's 
check ST, and put the results of the check onto the stack: 

-fi DfiDfl LDX $RD 
.fi DfiDfi PHP 

If ST IS zero, the Z flag will be set; we'll preserve this flag along with the 
others until we call it back from the stack. If you are adapting this program 
for the PET/CBM, don't forget that S T is at address $ R fc for your machine. 

The next thing we want to do is to disconnect the input by calling $FFCC; 
but this will destroy the A register. How can we preserve this value? By 
transferring to another register, or by pushing A to the stack. Let's do that. 
There will now be two things on the stack. 

.A DADB PHfi 

We are now free to disconnect from the input channel and connect to the 
output. Here we go: 



.a 


□aoc 


JSR 


$FFCC 


.a 


oaoF 


LDX 


#$0E 


.a 


oaii 


JSR 


$FFCR 


.a 


DMA 


PLa 





The A register gets back the last thing saved to the stack, and that, of 
course, is our input character. We're ready to send it to the output device: 

.A DfilS JSR $FFD2 
.fi Dfilfl JSR $FFCC 

Now we may pick up on the condition of ST that we stacked away earlier. 
Here come the flags that we stored: 

.A DfilB PLP 

If the Z flag is set, we want to go back and get another character. If not, 
we're finished and can return to BASIC, allowing BASIC to close the files 
for us: 

.A DfilC BEQ $□&□□ 
.A DAIE RTS 

Important: Before running this program, be sure to move the start-of- 
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variables pointer ($DD2D/$DD2E) so that it points at address $DA1F; 
otherwise, the BASIC variables will destroy this program. 

Review: The Instruction Set 

We started with the load, save and compare for the three data registers: 

LDA LDX LDY 
STA STX STY 
CMP CPX CPY 

The instructions are almost identical in action, although only the A register 
has indirect, indexed addressing modes. We continued with the logical 
and arithmetic routines that apply only to A- 

AND ORA EOR ADC SBC 

Anthmetic also includes the shift and rotate instructions, which may be 
used on the A register or directly upon memory: 

ASL ROL LSR ROR 

Memory may also be directly modified by the increment and decrement 
instructions, which have related instructions that operate on X and Y: 

INC DEC 
INX DEX 
INY DEY 

We may transfer control by means of branch instructions, which are all 
conditional: 

BEQ BCS BMI BVS 
BNE BCC BPL BVC 

The branch instructions can make only short "hops"; the jump instruction 
is unconditional: 

JMP 

Subroutines are called with the jump-subroutine, and returned with return- 
from-subroutine; we may also return from interrupts: 

JSR RTS RTI 

We may modify any of several flags with the appropriate set or clear 
command. Some of the flags control internal processor operation: for ex- 
ample, the I (interrupt disable) flag locks out the interrupt; the D (decimal 
mode) affects the way the ADC and SBC work with numbers. 
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SEC SEI SED 

CLC CLV CLI CLD 

We may transfer information between the A register and X or Y; and for 
checking or setting the stack location, we may move the stack pointer to 
X, or X to the stack pointer. The latter is a powerful command, so use it 
with care. 

TAX TAY TSX 
TXA TYA TXS 

We may push or pull information from the stack: 

PHA PHP 
PLA PLP 

There's a special test, used mostly for checking I A chips: 
BIT 

The BIT test is used only for specific locations: no indexing is allowed. 
The high bit from the location being tested is transferred straight to the N 
flag. The next highest bit (bit b) goes straight to the V flag. Finally, the Z 
flag is set according to whether the location has any bits set that match 
bits set in the A register. Thus, we can check a location with BIT $ ... . 
■followed by BMI to test the high bit, or BVS to test bit b, or BNE to test 
any selected bit or group of bits. It's a rather specialized instruction, but 
useful for testing input/output ports. 

Finally, the instruction that does nothing, and the BRK instruction that 
causes a "false interrupt," usually taking us to the monitor: 

NOP BRK 

That's the whole set. With these instructions, you can write programs to 
make the computer do whatever you choose. 

Debugging 

When a program has been written, the next step is to look for any possible 
errors, or bugs. The process of searching for and systematically elimi- 
nating these bugs is called debugging. 

Most programs are made up of sections, each of which has a clear task 
to perform. When a program misbehaves, it may be easy to go to the area 
of the bug, since you can see which parts of the program are working and 
where things start to go wrong. 
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In case of doubt, you may insert breakpoints into your program. Replace 
selected instructions with the instruction BRK, this may be done by re- 
placing the instructions' op codes with the value □□. Run the program; 
when it reaches the first breakpoint, it will stop and the machine language 
monitor will become active. Examine the registers carefully to see whether 
they contain the values expected. Display memory locations that the pro- 
gram should have written; the contents will tell you whether the program 
has been doing its job correctly. 

When you have confirmed that the program is behaving correctly up to 
the breakpoint, replace the BRK command at that point with the original 
op code. Command . G to that address, and the program will continue to 
the next breakpoint. If it helps your investigation, you may even change 
memory or registers before continuing program execution. 

If you carried this procedure to the extreme, you might stop your program 
after every instruction. It would take time, but you would certainly track 
down everything the program did. 

The best debugging takes place at the time you write the program. Write 
sensibly, not "super cleverly," If you fear getting caught in an endless 
loop, insert a stop key test (JSR $FFE1) so that you'll still have control 
of the computer. 

Get to know your machine language monitor. The monitor uses a number 
of locations in memory; you'll have trouble deougging a program if it uses 
the same storage addresses as does your program. Every time you try to 
check the contents of a memory location to see what your program has 
done, you'll see the monitor working values instead — and that would be 
misleading and annoying. 

Symbolic Assemblers 

Throughout these exercises, we have used small, "nonsymbolic" assem- 
blers such as would be found within a machine language monitor. These 
are good for beginners; they parallel the machine code quite closely and 
allow you to keep the working machine clearly in focus. 

As you write bigger and better programs, these small assemblers will be 
less convenient. Forward branches and subroutines we have not yet writ- 
ten make it necessary for us to "guess" at the address and fix up our 
guess later. There is the possible danger that an address will be typed in 
wrongly ($03^5 instead of $035^), causing the program to fail. 

To help us write more ambitious programs, we may wish to turn to com- 
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mercially available assembler systems that allow labels or symbolic ad- 
dresses. If we wish to write code to call a subroutine to input numbers — 
we might not have written this subroutine yet — we can code JSR NUMIN. 
When we write the subroutine, we'll put the identifying label NUMIN at the 
start. As your program is assembled, the proper address of NUMIN is de- 
termined, and this address will be inserted as needed. 

It saves work and helps guard against errors. But symbolic assemblers 
allow a more powerful capability: they help documentation and allow pro- 
gram updating. 

Your assembly may be listed to the pnnter. This allows you to examine 
and annotate the program, and file the details away for later reference. 
The assembler allows you to include comments, which improve the read- 
ability of the listing but don't affect the machine language program. 

The source program you have written may be saved and used again later. 
If you find it is necessary to change the program, bring back the source 
code from cassette or disk, make the changes, and reassemble. In this 
way, programs can be easily corrected or updated. 

Where To Go From Here 

Almost anywhere. Up to this point, we've been building confidence: trying 
to give you a feel as to how the pieces work. Now, the real fun — the 
creative programming — is up to you. 

Users have varying objectives. You may want to do mathematical oper- 
ations. You may want to interact upon BASIC programs— analyzing, 
searching, renumbenng. Whatever suits you. Your interest area may be 
music, graphics, or animation. Machine language will open the door to all 
of these; its amazing speed makes spectacular effects possible You may 
plan to go into hardware and interface new devices to your computer; an 
understanding of machine language, and I A chips in particular, will be 
useful. The possibilities are endless. 

Even if you have no immediate plans to write new programs in machine 
language, you will have gained an insight into the workings of your ma- 
chine. Everything that the machine does— BASIC, kernal, everything— is 
either hardware or machine language. 

With the elementary concepts we have introduced here, you will be able 
to go deeper into more advanced texts Many programming books deal 
with the abstract 650x chip. That's hard for the beginner; it's difficult to 
see how the instructions fit within the architecture of a real machine, or 
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how the programs can actually be placed within the computer. By now, 
you should be able to take a piece of abstract coding and fit it into your 
system. 

Many things start to happen at once when you take your first steps in 
machine language programming. You must learn how to use the monitor. 
You must learn a good deal about how your machine is designed. And 
you must learn how to fit the pieces together. It takes a while to adapt to 
the "information shock" — but things start to fit together. Eventually, you'll 
have a stronger and sounder view of the whole computer: hardware, soft- 
ware, languages, and usage. 

What You Have Learned 

— Machine language programs can have run times estimated fairly accurately 
In many cases, however, machine language is so fast that detailed speed 
calculations are not needed. 

— We can handle input from devices other than the keyboard by switching the 
identity of the designated input device If an input channel has been opened 
as a file, we may connect to it with JSR $FFCt. and disconnect with JSR 
$FFCC 

— We can handle output to devices other than the screen by switching the 
identity of the designated output device If an output channel has been opened 
as a file, we may connect to it with JSR $FFCR and disconnect with JSR 
$FFCC 

— Once input or output has been switched, we may receive in the usual way 
with the subroutine at $FFE^, or send in the usual way with the subroutine 
at $FFD2. 

— Be careful not to confuse connecting to a channel with opening a file in a 
typical program, we open a file only once, but we may connect to it and 
disconnect from it hundreds of times as we read or write data 

— You have met all the instructions of the 650x microprocessor There are 
enough for versatility, but not so many that you can't keep track of them all. 
You have made a worthwhile start in the art and science of machine language 
programming. 

Questions and Projects 

Write a program to read a sequential file and count the number of times 
the letter »»A'» (hex ^1) appears in the file. Use a BASIC PEEK to print 
the value. You may assume that "A" will not appear more than 25 5 
times. 
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Rewrite the above to count the number of occurrences of the RETURN 
character ($DD) in a sequential file. Allow for up to b 553 5 appearances. 
Can you attach a meaning to this count? 

Write a program to print HAPPY NEW YEAR to the printer ten times. 

If you own a disk system, you know that you can scratch a program named 
JONK by using the sequence: 

OPEN 15,fl ,15:PRINT#15, »»SD : JUNK". Convert the PRINT# 
statement to machine language and write a program to scratch JUNK. 
Careful: don't scratch a program that you will need. 

Write a "typewriter" program to read a line of text from the keyboard and 
then transfer it to the printer. It will be a more useful program if you show 
what is being typed on the screen and if you write extra code to honor 
the DELETE key. 



A 



The 6502/ 

651 0/6509/ 
7501 

Instruction 
Set 

The four chips differ only in their use of addresses and 1 : 
On the 6502, the addresses are normal memory. 

On the 6510 and 7501 , address □ is a directional register and address 1 is an 
input/output register, used for such things as cassette tape and memory control. 

On the 6509, address □ is used to switch program execution to a new memory 
bank; address 1 is used to switch the memory bank accessed by the two 
instructions LDfi ( . . ) / Y and STfi ( . . ) / Y 
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Addressing Modes 

Accumulator Addressing — This form of addressing is represented with a 
one byte instruction, implying an operation on the accumulator. 

Immediate Addressing — In immediate addressing, the operand is con- 
tained in the second byte of the instruction, with no further memory ad- 
dressing required. 

Absolute Addressing — In absolute addressing, the second byte of the 
instruction specifies the eight low order Dits of the effective address while 
the third byte specifies the eight high order bits. Thus, the absolute ad- 
dressing mode allows access to the entire 65K bytes of addressable mem- 
ory. 

Zero Page Addressing — The zero page instructions allow for shorter code 
and execution times by only fetching the second byte of the instruction 
and assuming a zero high address byte. Careful use of the zero page can 
result in significant increase in code efficiency. 

Indexed Zero Page Addressing— {X, Y indexing)— This form of address- 
ing is used in conjunction with the index register and is referred to as 
"Zero Page, X" or "Zero Page, Y." The effective address is calculated by 
adding the second byte to the contents of the index register. Since this is 
a form of "Zero Page" addressing, the content of the second byte refer- 
ences a location in page zero. Additionally, due to the "Zero Page" ad- 
dressing nature of this mode, no carry is added to the high order eight 
bits of memory and crossing of page boundaries does not occur. 

Indexed Absolute Addressing— (X, Y indexing)— This form of addressing 
is used in conjunction with X and Y index register and is referred to as 
"Absolute, X," and "Absolute, Y." The effective address is formed by 
adding the contents of X and Y to the address contained in the second 
and third bytes of the instruction. This mode allows the index register to 
contain the index or count value and the instruction to contain the base 
address. This type of indexing allows any location referencing and the 
index to modify multiple fields resulting in reduced coding and execution 
time. 

Implied Addressing— \n the implied addressing mode, the address con- 
taining the operand is implicitly stated in the operation code of the instruc- 
tion. 

Relative Addressing— Re\a\\\/e addressing is used only with branch in- 
structions and establishes a destination for the conditional branch. 

The second byte of the instruction becomes the operand which is an 
"Offset" added to the contents of the lower eight bits of the program counter 
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when the counter is set at the next instruction. The range of the offset is 
~12fl to +127 bytes from the next instruction. 

Indexed Indirect Addressing— \n indexed indirect addressing (referred to 
as [Indirect, X]), the second byte of the instruction is added to the contents 
of the X index register, discarding the carry. The result of this addition 
points to a memory location on page zero whose contents are the low 
order eight bits of the effective address. The next memory location in page 
zero contains the high order eight bits of the effective address. Both mem- 
ory locations specifying the high and low order bytes of the effective ad- 
dress must be in page zero. 

Indirect Indexed Addressing — In indirect indexed addressing (referred to 
as [Indirect, Y]), the second byte of the instruction points to a memory 
location in page zero. The contents of this memory location are added to 
the contents of the Y index register, the result being the low order eight 
bits of the effective address. The carry from this addition is added to the 
contents of the next page zero memory location, the result being the high 
order eight bits of the effective address. 

Absolute Indirect — The second byte of the instruction contains the low 
order eight bits of a memory location. The high order eight bits of that 
memory location is contained in the third byte of the instruction. The con- 
tents of the fully specified memory location are the low order byte of the 
effective address. The next memory location contains the high order byte 
of the effective address which is loaded into the sixteen bits of the program 
counter. 



Instruction Set — Alphabetic Sequence 



fiSL 



AND 



ADC 



Add Memory to Accumulator with Carry 

"AND" Memory with Accumulator 

Shift Left One Bit (Memory or Accumulator) 



BCC 



Branch on Carry Clear 
Branch on Carry Set 
Branch on Result Zero 



BCS 



BEQ 
BIT 



Test Bits in Memory with Accumulator 
Branch on Result Minus 



BMI 



BNE 
BPL 



Branch on Result not Zero 
Branch on Result Plus 
Force Break 



BRK 
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BVC 


Branch on Overflow Clear 


BVS 


Branch on Overflow Set 


CLC 


Clear Carry Flag 


CLD 


Clear Decimal Mode 


CLI 


Clear Interrupt Disable Bit 


CLV 


Clear Overflow Flag 


CMP 


Compare Memory and Accumulator 


PD Y 

V-. ir A 


OUrTl|Jart; IVItJlTlUry ailU lilUCA A 


CPY 


Compare Memory and Index Y 


DEC 


Decrement Memory by One 


TlT? Y 


ucLrernerii inucx a uy wne 


DEY 


Decrement Index Y by One 




cxL.iusiVc-vjn iviemory wiin MLL-umuiaior 


INC 


Increment Memory by One 


INX 


Increment Index X by One 


INY 


Increment Index Y by One 


JMP 


Jump to New Location 


u kj r\ 


himn NIoxa/ I nr*attnn Qa\/inn Rotiirn AHHr^cc 


TDD 


LUaU MLLiUrilUlalUr Willi ivicriiury 


LDX 


Load Index X with Memory 


LDY 


Load Index Y with Memory 


LSR 


Shift One Bit Right (Memory or Accumulator) 


MOP 


INU wptfl diiun 


ORfi 


"OR" Memory with Accumulator 


PHfi 


Push Accumulator on Stack 


PHP 


Push Processor Status on Stack 


PLfi 


Pull Accumulator from Stack 


PLP 


Pull Processor Status from Stack 


ROL 


Rotate One Bit Left (Memory or Accumulator) 


ROR 


Rotate One Bit Right (Memory or Accumulator) 


RTI 


Return from Interrupt 
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T5 m c 


Return from Subroutine 


SBC 


Subtract Memory from Accumulator with Borrow 


SEC 


Set Carry Flag 


SED 


Set Decimal Mode 


SEI 


Set Interrupt Disable Status 


STA 


Store Accumulator in Memory 


STX 


Store Index X in Memory 


STY 


Store Index Y in Memory 


TAX 


Transfer Accumulator to Index X 


TAY 


Transfer Accumulator to Index Y 


TSX 


Transfer Stack Pointer to Index X 


TXA 


Transfer Index X to Accumulator 


TXS 


Transfer Index X to Stack Register 


TYA 


Transfer Index Y to Accumulator 



Programming Model 



15 



PCH 



8 7 



PCL 



N 


V 




B 


D 


1 


Z 


c 



ACCUMULATOR A 

INDEX REGISTER Y 

INDEX REGISTER X 

PROGRAM COUNTER PC" 

STACK POINTER "S" 

PROCESSOR STATUS REG "P" 



CARRY 1 = TRUE 

ZERO 1 = RESULT ZERO 

IRQ DISABLE 1 - DISABLE 

DECIMAL MODE 1 - TRUE 

BRK COMMAND 



OVERFLOW 
NEGATIVE 



1 = TRUE 
1 = NEG 



Figure A.1 
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PET— Original ROM 

The first PET. It can be recognized by the message seen at power up: 

*** COMMODORE BASIC *** 

using astensl<s but with no identifying number after the word BASIC. 

The original machine may be upgraded to Upgrade ROM by fitting a new 
set of ROM chips. This is a good idea, since the original logic cannot 
handle disk, does a poor job on cassette data files, has no built-in machine 
language monitor, and has a zero page architecture that differs significantly 
from all later PET/CBM's. The BASIC language on this unit is also limited; 
arrays may not contain over 256 elements, for example. 

This early machine is becoming rare. 

PETICBM— Upgrade ROM 

The first PET that can handle disk. It can be recognized by the message 
seen at power up: 

### COMMODORE BASIC ### 

using the numbers sign (or octothorpe, if you like). 

This IS much cleaner logic than the previous machine. Its internal structure 
is similar to that of later PET/CBM units (the 4.0 machines), so that it has 
much in common with them. 

It does not have specialized disk commands such as CATALOG, 
SCRATCH, or DLOAD (the 4.0 disk commands); but these are "conve- 
nience" commands and the Upgrade ROM unit can do everything that the 
later units do. 

Upgrade ROM machines have a BASIC annoyance: under some circum- 
stances, string variables need to be tidied up using a technique called 
"garbage collection." This takes place automatically when needed; but 
when it does, the machine will freeze and seemingly will be dead for a 
period that may last from a few seconds to as long as a half hour or more. 

PETICBM— 4.0 ROM and 80 Characters 

This class of machine has been a mainstay of the Commodore line for 
years. It may be recognized by the message seen at power up: 

*** COMMODORE BASIC ^ .□ *** 

For the first time, a number appears in the message. 
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These machines are characterized by new BASIC disk commands 
(CATALOG, etc.) and elimination of garbage-collection delays. Their in- 
ternal architecture, especially zero page, is quite similar to the previous 
Upgrade ROM computers. 

Some time after the initial production of 40-column machines, 80-column 
machines were introduced, as well as a new 40-column version called the 
"fat 40." The later machines are distinguished by new screen/keyboard 
features, most noticeable of which is that the cursor movement keys repeat 
automatically. 

Subsequently, two memory-expanded machines became available. The 
8096 came fitted with 96K of RAM; the extra 64K was "bank switched" 
into memory as needed in blocks of 16K. The SuperPET, too, had an 
extra 64K of RAM that was bank switched in 4K blocks; it also came with 
an additional microprocessor (the 6809) used primarily for implementing 
high-level languages. Both the 8096 and the SuperPET may be used as 
conventional CBM 8032 computers; the extra memory may De ignored. 

VlC-20 

The VIC-20 was a new design concept for Commodore. Color, graphics, 
and sound were built into the computer The memory architecture changed 
radically. Zero-page locations were shifted significantly as compared to 
previous PET/CBM computers. 

BASIC reverted to Upgrade ROM style— no special disk commands and 
potentially slow garbage collection. Other than that, BASIC was not trimmed. 
All the functions and features remained, and some attractive new screen 
editing features were added, such as automatic repeating keys. 

The VIC comes with no machine language monitor, it's necessary to load 
one. The SYS command has a new attractive feature that allows registers 
A, X, and Y to be "preloaded" by POKEing values into addresses 780, 
781, and 782. Location 783 could also be used to set the status register, 
but that's dangerous; unless its done carefully, the decimal mode or in- 
terrupt disable flags might be set inadvertently. 

The VIC-20 is somewhat vexing for machine language programming work. 
Depending on the amount of extra memory fitted (none, 3K, or 8K and 
over), the location of start-of- BASIC and of screen memory will vary. 

Commodore 64 

The Commodore 64 has much in common with the VIC-20. In particular, 
its zero page organization is almost identical to that of VIC. The Com- 



758 



MACHINE LANGUAGE FOR COMMODORE MACHINES 



modore 64 comes with a 6510 microprocessor; addresses □ and 1 are 
reserved for "bank switching" of memory. 

BASIC is identical to that of the VIC— no special disk commands and 
potentially slow garbage collection. There's no built-in machine language 
monitor, so one must be loaded. The SYS command, as with the VIC, 
allows preloading of registers A, X, and Y if desired. 

The Commodore 64 has a more stable architecture than the VIC. BASIC 
starts in a consistent place, and the screen is always at hex □□ unless 
you move it. There's a bank of memory at SCDDD to $CFFF that is not 
used by the computer system; it's useful for staging machine language 
coding. 

The Commodore 64 is the first Commodore machine in which it is some- 
times desirable to write totally in machine language, with no BASIC at all. 
BASIC can be swapped out to release extra RAM, and large applications 
(word processors, spread sheets, and so on) are likely to do this. 

Commodore PLUSI4 

Similar to the Commodore 64 in many ways. The processor is a 7501, 
which has the same instruction set as the 6502. Screen memory and 
BASIC RAM have been moved a little higher. BASIC itself is greatly ex- 
panded. 

Color and sound are implemented differently to the Commodore 64. 

There's a built-in machine language monitor with expanded features, such 
as assemble and disassemble. This one is convenient for machine lan- 
guage programmers. 

The memory arrangement is more sophisticated than on previous ma- 
chines; large implementations may require insight into the machine's de- 
tailed architecture. 

B Series 

The B-1 28, B-256, CBM-1 28, and CBM-256 were designed as successors 
to the 80-column PET/CBM units. Architecture has been radically changed: 
the processor is a 6509, memory is bank switched, and zero page is 
significantly different from that of other models 

The cassette buffer is no longer at $DBBD, so that the examples given 
in this book will need to be moved to a new part of RAM (addresses 
$D^DD to $n7FF are available). Bank switching is more complex than 
on other models. Beginners will find that there are more things to be kept 
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track of in this machine. If possible, beginners should try to find a simpler 
computer on which to take their first steps. 

Implementation of large-scale programs require setting up a "transfer se- 
quence" program to link the program's memory bank to that of the kernal. 
Usually, a bootstrap program will be needed to set everything up. 

A machine language monitor is Duilt into this line of machines. A few new 
commands have been made available: . V to switch banks, .(a to test 
disk status. 



c 

Memory 
Maps 

A word about memory maps: they are always too big or too small for the 
use you have in mind. 

The beginner may feel swamped by the wealth of detail. There's no threat, 
however. The information is there when you're ready for it. Browse through 
the information; it may be thought-provoking. Try reading or changing 
locations to see what happens. 

The advanced programmer may want more: lengthy details on how each 
location is used, which parts of the system use these locations, and so 
on. Time and space don't permit such detail. 

The maps are intended to be fairly complete. Those who want more detail 
may find them cryptic; but at least each location will be associated with a 
type of activity. Different machines may be compared by checking their 
respective maps. In some cases, programs may be converted with their 
use, since they will help to find the corresponding memory location in the 
target machine. 

When you see a reference to a POKE or PEEK location— in this book or 
from other sources— check it in these maps. They will help add perspec- 
tive. 
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"Original ROM" PET 

The Great Zero-Page Hunt 

Most users help themselves to the high part of the input buffer ($DD4 □ 
to $ □ □ 5 , which IS not used except when long lines of data are inputted. 

Most zero-page locations may be copied to another part of memory so 
that their original contents can be restored after use. However, the pro- 
grammer should take great care In modifying the following locations, which 
are critical within the operating system or BASIC. $03, $05, $t< to 
$t7, $7Ato$fl7, $flq, $AEto$A3, $B7, $CEto$Dq, $EDto$EE, 
$F5. 

Memory Map 



nex 




Decimal 


L/c?oO/ IfJUUf f 




DDDE 


□ - 


■E 


USR jump 


DDD3 




3 




Current I/O -prompt 










suppress 


DDD5 




5 




Cursor control position 


DDDfl- 


□ DDq 


fl- 


■q 


Integer value (for SYS, GOTO, 










and so on) 


□ □DA- 




ID- 


•aq 


Input buffer 


DD5A 








Search character 


DD5B 




qi 




Scan-between-quotes flag 


DD5C 




qE 




Input buffer pointer; number of 










subscripts 


□ □5D 




q3 




Default DIM flag 


DD5E 




q4 




Type: FF= string; 










□ □ = numeric 


DD5F 




qs 




Type: 80 = integer; 00 = floating 










point 


DDtD 




qt 




Flag: DATA scan; LIST quote; 










memory 


DDtl 




q7 




Subscript flag; FNX flag 


□ DtE 




qa 




□=INPUT; $^D=GET; 










$qfl=READ 


□ Dt3 




qq 




ATN sign/comparison 










evaluation flag 


□ □t^ 




IDD 




Input flag (suppress output) 




■DDt7 


IDl- 


■1D3 


Pointers for descriptor stack 
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Hex 




Decimal 


Description 


□ □tfl- 


•□□7^ 


IDA 


-HE 


Descriptor stack (temporary 










strings) 


□ □71- 


•□□7^ 


na- 


-lit 


Utility pointer area 


□ □75- 


■□□7fl 


il? 


-lED 


Product area for multiplication 


□ □7ft- 


□ □7B 


lES 


-lE^ 


Pointer: start-of-BASIC 


□ □?C- 


■□□7D 


lE-^ 


-1E5 


Pointer: start-of-variables 


□ □7E- 


□ □7F 


lEt- 


-1E7 


Pointer: start-of-arrays 


□ □fl^- 


□ □fll 


lEa- 


-lEq 


Pointer: end-of-arrays 


□ □flE- 


■□□fl3 


13D- 


-131 


Pointer: stnng-storage (moving 










down) 


□ □fl^- 


•□□as 


13E 


-133 


Utility string pointer 


□ □flt- 


□ □a7 


13-^ 


-135 


Pointer: limit-of-memory 


□ □flfl- 


□ □aq 


13t 


-137 


Current BASIC line number 


□ □flft- 


•□□aB 


13a 


-13q 


Previous BASIC line number 


□ □flC- 


□ □ao 


l-^D- 


-1-^1 


Pointer:BASIC statement for 










CONT 


□ □flE- 


•□□aF 


l-^E 


-1-^3 


Current DftTft line number 


□ □q^- 


□□qi 




-1-^5 


Current DftTft address 


□ □SE- 


■□□q3 


lAh 


-1^7 


Input vector 


□ □q^- 


■□□qs 




-i^q 


Current variable name 


□□qt- 


■□□q7 


ISO- 


-151 


Current variable address 


□□qa- 


■□□qq 


15E- 


-153 


Variable pointer for FOR/NEXT 


□ □qfi- 


■□□qB 


15^- 


-155 


y-save; op-save; BASIC 










pointer save 


□ □qc 




15t 




Comparison symbol 










accumulator 


□ □qo- 


•□□fiE 


157 


-ItE 


Miscellaneous work area, 










pointers, and so on 


□ □fi3- 


•□□fiS 


lt3- 


-lt5 


Jump vector for functions 


□ □fit- 


■□□fiF 


Itt 


-175 


Miscellaneous numeric work 










area 


□ □BD 




17t 




Accum#1 : exponent 


□ □Bl- 




177- 


-lao 


Accum#1 : mantissa 


□ □B5 




lai 




Accum#1 :sign 


□ □Bt 




laE 




Series evaluation constant 










pointer 


□ □B7 
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Accum#1 hi-order (overflow) 


□ □Bfl- 


□ □BD 


la^- 


-laq 


Accum#2: exponent, and so on 


□ □BE 




iqo 




Sign comparison, Acc#1 versus 










#2 


□ □BF 




iqi 




Accum#1 lo-order (rounding) 
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Hex 




Decimal 


Description 


□ □CD- 


■□□CI 


I'^E- 


-l'^3 


Cassette buffer length/series 










pointer 


□ □CE- 


■□□DR 




-E17 


CHRGET subroutine; get 










BASIC character 


□ □C^- 


□ □CA 


BUl- 




BASIC pointer (within 










subroutine) 


□ □DA- 


□ □DE 


Elfl- 


-EEE 


Random number seed 


□ □ED- 


■□□El 


EE^- 


■EES 


Pointer to screen line 


□ □EE 




EEt 




Position of cursor on above line 


00E3- 


■□□E4 


EE?- 


■EEfl 


Utility pointer: tape, scroll 


□ □E5- 


■□□E t 


EEq- 


■E3^ 


Tape end address/end of 










current program 


□ □E7- 


■□□Efl 


E31- 


■E3E 


Tape timing constants 


□ OER 




E33 




Tape buffer character 


□ □EA 








Direct/programmed cursor: 










□ = direct 


□ □EB 




E35 




Tape read timer 1 enabled 


□ □EC 




E3t 




EOT received from tape 


□ □ED 




E37 




Read character error 


□ □EE 




E3fl 




Number of characters in file 










name 


□ □EE 




E3R 




Current file logical address 


□ □F^ 




EAO 




Current file secondary address 


□ □El 




EAl 




Current file device number 


□ □EE 




E^E 




Line margin 


□ □F3- 


■□□F^ 


E^3- 




Pointer: start of tape buffer 


□ □F5 








Line where cursor lives 


□ □Ft 




E4 t 




Last key/checksum/ 










miscellaneous 


□ □F7- 


■□□Efl 


E^7- 


■E^fl 


Tape start address 


□□Fq- 


■□□Fft 


E^R- 


■E5^ 


File name pointer 


□ □EB 




E51 




Number of INSERTS 










outstanding 


□ □EC 




E5E 




Write shift word/read character 
in 


□ □ED 




E53 




Tape blocks remaining to write/ 










read 


□ □EE 




ESA 




Serial word buffer 


□ !□□- 


□ l^A 


E5t- 


-Ett 


STR$ work area 


□ !□□- 


■□13E 


E5t- 


-31fl 


Tape read error log 


□ !□□- 


□ IFF 


E5t- 


-511 


Processor stack 



APPENDIX C 



165 



Hex 


UeCirnQI 


uescnpiion 


□EOD-DEDE 


51E-513 


Jiffy clock for TI and TI$ 


□ ED3 


515 


Which key down: E 5 5 = no key 




51t 


Shift key: 1 if depressed 


□ED5-DED t 


517-51fl 


Correction clock 


□ED?-DEDfl 

U l_ UJ > UJ I— U LJ 


51R-5ED 


Cassette status, #1 and #E 


U 1— Ul 1 


5E1 


Keyswitch PIft: STOP and 






RVS flags 


u i_ u n 


5EE 


Timing constant for tape 


DEDB 


5E3 


Load = 0; verify =1 


□ EDC 


5E^ 


Status word ST 


UJ I— UJ J--' 


5E5 


Number of characters in 






keyboard buffer 


□ EDE 


5Et 


Screen reverse flag 


□EDF-DElfl 


5E7-53t 


Keyboard input buffer 


□ El'^-QEIA 


537-53fl 


IRQ vector 


□EIB-DEIC 


53^-5^0 


BRK interrupt vector 


□ EID 


5^1 


IEEE output: E 5 5 = character 






pending 


□ ElE 


5^E 


End-of-line-for-input pointer 


□EED-DEEl 

l-J L_ 1 l-J 1— 1 1 — 1 — JJ 


5^^-5^5 


Cursor log (row, column) 


□ EEE 


SAh 


IEEE output buffer 


□ EE3 


SA7 


Key image 


□ EE^ 




□ = flash cursor 


□ EE5 




Cursor timing countdown 


□ EEt 


55D 


Character under cursor 


□ EE? 


551 


Cursor in blink phase 


□ EEfl 


55E 


EOT received from tape 


□ EE'^-DE^l 


553-577 


Screen line wrap table 


□E^E-DE^B 


57fl-5fl7 


Flip InnirpI pdrirp^^ tphip 


LJ l_ ^ LJ (_ _) _) 


J u u J n r 


riie oevice nuiTiDer laDie 




c q A L ri"? 
□ n Q — tj u r 


File secondary address table 




O VJ u 








keyboard 


DEtl 




X save 


□ EtE 




How many open files 


DEt3 


til 


Input device, normally 


DEt^ 


tlE 


Output CMD device, normally 3 


□ EtS 


tlB 


Tape character parity 


□ Ett 


tl^ 


Byte-received flag 


DEtfl-DEtq 


tl5-tlt 


File name pointer; counter 
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Hex 




Decimal 


Descr;pf/on 


□ Etc 




tED 




Serial bit count 


□ EtF 




tE3 




Cycle counter 


□ E7D 




tE^ 




Tape writer countdown 


□ E71- 


-□E7E 


tES- 


•tEt 


Tape buffer pointers, #1 and 










#E 


□ E73 




tE7 




Write leader count; read pass 
1/2 


□ E7^ 




tEfl 




Write new byte; read error flag 


□ E75 




tEq 




Write start bit; read bit 










sequence error 


□ E7t- 


-□E77 


t3D- 


■t31 


Error log pointers, pass 1/2 


□ E7fl 




E.3E 




□ = scan/l-15 =count/ 










$';;D = load/$flD = end 


□ E7q 




t33 




Write leader length; read 










checksum 


□ E7a- 


-□33q 


k3A- 


■flES 


Tape#l input buffer 


□ 33a 


-□3Fq 


flEt- 


■1D17 


Tape#E input buffer 


□ 3Fa- 


-□3FB 


IDlfl- 


■iDiq 


Monitor extension vector 


□ ^□D- 


-7FFF 


IDE-^- 


■3E7t7 


Available BAM including 










expansion 


flDDD- 


-fl3E7 


3E7tfl- 


■337t7 


Screen RAM memory 


CDDD- 


-E7Ffl 


<qi5E- 


■5q3fl^ 


BASIC ROM; part of kernal 










ROM 


EfllD- 


-Efll3 




■SRAll 


PI A 1 (6520)-keyboard 










interface 


EflED- 


-EflE3 




•5q<E7 


PIA E (6520)-IEEE interface 


Efl^D- 


-Efl-^F 






VIA (6522)-Miscellaneous 










interface, timers 


FDDD- 


-FFFF 




■t5535 


Kernal ROM routines. 



PIA and VIA charts are the same as shown for Upgrade/4.0 units. 



UPGRADE and BASIC 4.0 Systems 

The Great Zero-Page Hunt 

Zero-page locations are tough to find in these areas. Locations $1F to 
$E7, to $5D, and $5-^ to $5D are work areas available for tem- 
porary use. If tape is not being read or written, addresses $B1 to $C3 
are available. 
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Most zero-page locations may be copied to another part of memory so 
that their original contents can be restored after use. The programmer 
should take great care, however, in modifying the following locations, which 
are critical within the operating system of BASIC: $10, $13 to $15, 
$Efl to $3 5, $37, $5 to $51, $t5, $?□ to $fl7, $flD to $BD, $C^ 
to $FA. 

Memory Map 

Where Upgrade ROM differs from 4.0, an asterisk is shown and the 4.0 
value is given. There are some differences in usage between the 40- and 
80-column machines. 



Hex 




Decimal 


Description 


n n n n 
U U U U — 


n n n D 


n 

□ - 


-E 


UoK jump 


n n n "3 
U □ U J 




3 




Search character 


□ □□^ 




A 




Scan-between-quotes flag 


n n n f 

□ □□5 




5 




Input buffer pointer; number of 










subscripts 


n n n r 
□ □□b 




r 

b 




r\^t^, ill- TV T M tl^M 

Default Din flag 


n n n "5 
UUU r 




7 




Type: FF = string; □□ = numeric 


n n n fl 

□ uufl 




fl 




Type: flO = integer; 










□ □ = floating point 


n n n n 

□ □□H 








Flag: DATA scan; LIST quote; 










memory 


n n n 7\ 

U U U ii 




1^ 




oUDscripi Tiag, r w a Tiag 


□ OOB 




11 




□=INPUT; $^D=GET; 










$qfl=READ 


ODOC 




IE 




ATN sign/comparison 










evaluation flag 


OODD- 


□ □OF 


13- 


■15 


*Disk status DS$ descriptor 


□ 010 




It 




*Current I/O device for prompt- 










suppress 


□ 011- 


•□□IE 


17- 


■Ifl 


Integer value (for SYS, GOTO, 










and so on) 


□ 013- 


□ 015 


iq- 


•El 


Pointers for descriptor stack 


□ □It- 


OOIE 


EE- 


•30 


Descriptor stack (temporary 










strings) 


□ OlF- 


OOEE 


31- 


•34 


Utility pointer area 


□ 0E3- 


□ □E7 


35- 


■3q 


Product area for multiplication 


□ DEfl- 


□ OEq 


^□- 


■41 


Pointer: start-of-BASIC 


□ □EA- 


□ □EB 




■43 


Pointer: start-of-variables 


□ □EC- 


OOED 


44- 


•45 


Pointer: start-of-arrays 
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MACHINE LANGUAGE FOR COMMODORE MACHINES 



Hex 




Decimal 


Descnption 


□ □EE 


-□□EF 


Ah 


-A7 


Pointer: end-of-arrays 


□ □3D 


-□□31 


A& 


-A<=\ 


Pointer: string-storage (moving 


□ □3E- 








down) 


-□□33 


5D- 


-51 


Utility string pointer 


□ □3^- 


-□□35 


5S- 


-53 


Pointer: limit-of-memory 


□ □3t- 


-□□37 


SA- 


-55 


Current BASIC line number 


□ □3fl- 


-□□3q 


5t- 


-57 


Previous BASIC line number 


□ D3A- 


-□□3B 


sa- 


-5q 


Pointer: BASIC statement for 
CONT 


DD3C- 


-□□3D 




-tl 


Current DATA line number 


□ □3E- 


-□□3F 


tE- 


-t3 


Current DATA address 


□ □^;d- 


-DOAl 




-t5 


Input vector 


DD^E- 


-0QA3 


tt- 


-t? 


Current variable name 


□ D^t- 


-0QA7 


70- 


-71 


Variable pointer for FOR/NEXT 


DD^fl- 




7E- 


-73 


Y-save; op -save; BASIC 
pointer save 


□ □^A 




7A 




Comparison symbol 
accumulator 


□ □^B- 


-□□5^ 


75- 


-flO 


Miscellaneous work area, 


□ □51- 








pointers, and so on 


-□□53 


fll- 


-fl3 


Jump vector for functions 


□ □54- 


-□□5D 


fl^- 


-q3 


Miscellaneous numeric work 
area 


□ □5E 








Accum#1: exponent 


□ □5F- 


-□□tE 


q5- 


-qa 


Accum#1: mantissa 


□ □t3 








Accum#1: sign 


□ □t4 




!□□ 




Series evaluation constant 


□ □t5 








pointer 


-□□tB 


IDl 




Accum#1 hi-order (overflow) 


□ □tt- 


IDE- 


-1D7 


Accum#2: exponent, and so on 


□□tc 




IDfl 




Sign comparison, Acc#1 versus 


□ □tD 








#2 


■□□tF 






Accum#1 lo-order (rounding) 


□ □tE- 


IID- 


•111 


Cassette buffer length/series 


□ □?□- 








pointer 


•□□fl7 


llE- 


135 


CHRGET subroutine; get 
BASIC character 


□ □77- 


•□□7fl 


iiq- 


lED 


BASIC pointer (within 


□ □flfl- 


■□□flC 






subroutine) 


13t- 


14D 


Random number seed 


□ □flD- 


□ □flF 


141- 


143 


Jiffy clock for TI and TI$ 
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Hex 




Decimal 


Description 




□ □HI 


IZ,/,- 


1 y r* 

■1^5 


IRQ vector 


I— 1 n /— 1 — 1 


□ □H3 


1^ t- 


•1^7 


BRK interrupt vector 




□ □H5 




l^H 


NMI interrupt vector 


□ □qt 




-1 r- f— 1 




Status word ST 


n n n ~i 

□ uH? 




151 




Which key down: E 5 5 = no key 






15E 




Shift key: 1 if depressed 




■□□HA 


153- 


■15^ 


Correction clock 


□ □qB 




155 




Keyswitch PI A: STOP and 
RVS flags 


□ □RC 




15t 




Timing constant for tape 






lb? 




Load= □; verify =1 


n n n T71 

□ □HE 




15fl 




Number of characters in 
keyboard buffer 


□ □HF 




15H 




Screen reverse flag 


□ □AD 




itu 




IEEE output: E 5 5 = character 
pending 


□ □Al 




1 tl 




End-of-line-for-input pointer 


□ □A3- 


□ OA^ 


1 13- 


■1 1^ 


Cursor log (row, column) 


□ □A5 




lt5 




IEEE output buffer 


□ □At 




Itt 




Key image 


□ □A7 




It? 




□ == flash cursor 


□ OAfl 




It 




Cursor timing countdown 


□ □AH 




ItH 




Character under cursor 


□ □AA 




17^ 




Cursor in blink phase 


□ □AB 




171 




EOT received from tape 


□ □AC 




17E 




Input from screen/from 
keyboard 


□ □AD 




173 




X save 


□ □AE 








How many open files 


□ □ AF 




175 




Input device, normally 


□ □BD 




17t 




Output CMD device, normally 3 


□ □31 




177 




Tape character parity 


□ □BE 




17fl 




Byte-received flag 


□ □B3 




17S 




Logical address temporary save 


□ □B^ 




IflD 




Tape buffer character; MLM 
command 


n n r> c~ 

□ □Bb 




lai 




File name pointer; MLM flag; 
counter 


□ □B7 




133 




Senal bit count 


□ □BH 




135 




Cycle counter 


□ □BA 




lat 




Tape writer countdown 
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MACHINE LANGUAGE FOR COMMODORE MACHINES 



Hex 




Decimal 


Description 


□ □BB- 


-□□BC 


161- 


-Iflfl 


Tape buffer pointers, #1 and 










#E 


□ □BD 








Wnte leader count; read pass 










1/2 


□ □BE 








Write new byte; read error flag 


□ □BF 








Write start bit; read bit 










sequence error 


□ □C^- 


-□□CI 


IRE- 


-1^3 


Error log pointers, pass 1/2 


□ □CE 








□ = scan/1 -15 = count/ 










$^^ = load/$fl^ = end 


□ □C3 




iqs 




Write leader length; read 










checksum 


□ □C^- 


-□□C5 


iqt- 


•iq? 


Pointer to screen line 


□ □Ct 








Position of cursor on above line 


□ □C7- 


-□□Cfl 






Utility pointer: tape, scroll 


□ □CR- 


■□□CA 


EDl- 


-E^E 


Tape end address/end of 










current program 


□ □CB- 


•□□CC 


E^3- 


EQA 


Tape timing constants 


□ □CD 




E^S 




□ = direct cursor; else 










programmed 


□ □CE 




E^t 




Tape read timer 1 enabled 


□ □CF 




EQ7 




EOT received from tape 


□ □D^ 




EQ& 




Read character error 


□ □Dl 




EUR 




Number of characters in file 










name 


□ □DE 




ElO 




Current file logical address 


□ □D3 




Ell 




Current file secondary address 


□ □D^ 




ElE 




Current file device number 


□ □D5 




E13 




Right-hand window or line 










margin 


□ □Dt- 


□ □D7 


El^- 


E15 


Pointer: start of tape buffer 


□ □Dfl 




Elt 




Line where cursor lives 


□ □DR 




E17 




Last key/checksum/ 










miscellaneous 


□ □DA- 


□ □DB 


Elfl- 


EIR 


File name pointer 


□ □DC 




EEO 




Number of INSERTS 










outstanding 


□ □DD 




EEl 




Write shift word/read character 
in 


□ □DE 




EEE 




Tape blocks remaining to write/ 



read 



APPENDIX C 



171 



Hex 



Decimal 



Description 



□ □DF 




55B 




□ □EO- 


□ □Ffl 






n ri — 

U Uij u 


n np 1. 

U U Hi iJ 


PPZ _ 

C C H — 


ppc; 

C C Z3 


U U III C 




PPL 
c c □ 








P P7 




n rrpz 

U U Jj M 




PP A 
ecu 




u u Jj zi 




PPQ 

C C n 




n (IP L 
u u ri □ 




P"^ n 




□ 0E7 




531 




ODEfl 








n nPQ 

U U Jj n — 


n np n 
- u uri n 


P"^ 

C J J — 


P"^ z 

C J M 


n nPR 

U U Jj D — 


n npp 
-u uri u 


pq c;_ 
C J zj — 


• C J CD 


n nPQ — 


.n HP a 


p/ q_ 
c H n 


C ZD U 


u u r D — 


n npp 


C 13 iJ — 


pq P 
•CDC 


n npn 


n npp 
-u u r £i 


C 13 J — 


•pqz 

C Z3 M 


n 1. nn- 
Li ij u u 


.n 1. n a 

U iJ U H 


CIj □ 


-PL L 
c □ □ 


n 1. nn- 
Li ij u u 


.n 1. "^P 

Li Jl 3 £i 


CIj □ 


11. A 

J U (J 


n 1. n n 
U ij u u — 


n 1. PP 

u ij r r 


pc; L- 


- Z3 Jj Jj 


np nn_ 
u c u u 


.n pc;n 

U C 13 U 


Q 1. p_ 

13 JJ C 


Z3 1 C 


U C Zj JJ 


np^ n 




□ LJ I— 


(IP ^R- 

U C D D 


U ^ □ H 


□ U J 


■ LI.? 


U C □ 13 


.np LP 

U C □ Hi 


t3 iJ J 


• LPP 
□ c c 


u c □ r 


n P7 A 

' U C r (J 


□ C J 


• LIP 

□ DC 


nP7 a _ 


U J J ~ 


□ J H 


- A p q 

U C 13 


u J J H.- 


n PQ 


A P L 


1. n 1.7 

ij U ij r 


U J J H — 


n A n 

' U .3 □ u 


A P L 


A Q L 


U J Jjn 




1. n n 1. 

ij U U ij 








1. nnp 
ij u u c 




rr^PR 

III D 




1. nn"^ 

ij U U J 




n p 




1 n n X 




□ BED 




IQQS 




□ BEE 








□ 3EE- 


-□BF7 




•1015 


□ BEF 




!□□? 




□ BF^- 


■q 


!□□&- 


■1017 


□ BFA- 


■□3FB 




■loiq 



Serial word buffer 
(40-column) Screen line wrap 
table 

*(80-column) Top, bottom of 
window 

*(80-column) Left window 
margin 

*(80-column) Limit of keyboard 
buffer 

*(80-column) Key repeat flag 
*(80-column) Repeat countdown 
*(80-column) New key marker 
*(80-column) Chime time 
*(80-column) HOME count 
*(80-column) Input vector 
*(80-column) Output vector 
Cassette status, #1 and #5 
MLM pointer/tape start address 
MLM, DOS pointer, 
miscellaneous 

STR$ work area, MLM work 
Tape read error log 
Processor stack 
MLM work area; input buffer 
File logical address table 
File device number table 
File secondary address table 
Keyboard input buffer 
Tape#l input buffer 
Tape#5 input buffer 
*DOS work area 
(Fat 40) New key marker 
(Fat 40) Key repeat countdown 
(Fat 40) Keyboard buffer limit 
(Fat 40) Chime time 
(Fat 40) Decisecond timer 
(Fat 40) Key repeat flag 
(80-column) Tab stop table 
(Fat 40) Tab work value 
(Fat 40) Tab stops 
Monitor exterisiori vector 
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MACHINE LANGUAGE FOR COMMODORE MACHINES 



nex 




Decimal 


Description 






1 n z) n 
ij U c U 




itbb timeout aeteat 


U H IJ IJ 


f r r r 




^ "3 r "3 


AvaiiaDie kaw inciuaing 
expansion 


A n nn 

□ u u u 


— □ J Jj r 


~i ^ ~i r n 


-337b7 


(40-column) Video RAM 
(80-colurTin) Video RAM 


A n n n 
u u u 


— a r L r 






Q n n n 
n u u u 


— ar r r 




-^5055 


Available ROM expansion area 


Booa 


-E7FF 


^ f~ o i~ r 




BASIC ROM, part of kernal 


p A 1 n 
ri o ij u 


P A 1 "3 
-ti □ ij d 


5"^^ Dfl- 


-5'=1^ 11 


PI A 1 -keyboard I/O 


1? A P n 


•p A -) -n 






PI A 5-IEEE-488 I/O 




-Efl^F 




-5q^71 


VIA-l/0 and timers 


EflflD- 


-Eflfll 




-5^551 


(80-column and Fat 40) CRT 
controller 


FODO- 


-FFFF 




-L5535 


Kernal ROM 



6520 



E810 


Diag Sens/ 
Uncrash 


EOl in 


Tape Switch Sense 
#1 #2 


Keyboard Row Select 


59408 


E811 


Tape#1 In 
Latch 




(Screen Blank — Ong 
ROM) EOl Out 


DDRA 
Access 


Tape#1 Input L 
Control 


59409 


E812 


Keyboard Input for selected row 


59410 


E813 


Retrace 
Latch 




Cassette#1 Motor 
Output 


DDRB 
Access 


Retrace Interrupt 
Control 


59411 



Figure C.1 
PIA 1 chart 



6520 



E820 


iEEE-488 Input 


59424 


E821 


ATN Int 




NDAC Out 


DDRA 

Access 


ATN Int Control 


59425 


E822 


IEEE-488 Output 


59426 


E823 


SRQ Int 




DAV Out 


DDRB 

Access 


SQR Int Control 


59427 



Figure C.2 
PIA 2 cliart 
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6522 



E840 

E841 
E842 
E843 
E844 
E845 
E846 
E847 
E848 
E849 
E84A 

Ea4B 
E84C 



E84D 
E84E 

E846F 



DAV In 



NRFD In 



Retrace 
In 



Tape #2 
Motor 



Tape 
Output 



ATN Out 



NRFD 
Out 



NDAC In 



Unused (See E84F) 



Data Direction Register B (for E840) 



Data Direction Register A (for E84F) 



Timer 1 



Timer i Latch 



Timer 2 



Shift Register (unused) 



T1 Control 


T2 Cont 


Shift Register Control 


Latch Controls 
PB PA 


CB2 (PUP) Control 


CB1 CntI 
Tape#2 


CA2 Control 
Graphics/Text Mode 


CA1 
(PUP) 
Control 


Irq Stats 
Int EnabI 


Timer 
1 

Int 


Timer 
2 
Int 


CB1 
Tape#2 
Int 


CB2 
(PUB) 
Int 


SR 
Unused 


CA1 
(PUP) 
Int 


CA2 
G/T Mode 
unused 


Parallel User Port Data Register PA 



59456 

59457 
59458 
59459 
59460 
59461 
59462 
59463 
59464 
59465 
59466 

59467 
59468 



59469 
59470 

59471 



Figure C.3 
VIA chart 



CBM 8032 and FAT-40 
6545 CRT Controller 

NOTES: 1 . Registers are write-only. 

2. Avoid extreme clianges in Register 0. CRT damage could 
result. 

3. Register will adjust scan to allow interfacing to external 
monitor. 

4. Register 12, Bit 4, will "invert" the video signal. 

5. Register 1 2, Bit 5, switches to an alternate character set. The 
character set is not implemented on most machines except 
Super-PET. 
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$E840 



TYPICAL VALUES 
$E841 (DECIMAL) 
1 TEXT GRAPHICS 






HORIZONTAL TOTAL 


1 


HOR. CHAR. DISPLAYED 


2 


H. SYNC POSITION 


3 


V SYNC WIDTH h 


4 




VERTICAL TOTAL 


5 




VERT. TOT. ADJUST 


6 




VERTICAL DISPLAYED 


7 




VERT. SYNC POSITION 


8 


^X^ MODE 


9 


SCAN LINES 


10 
11 


—CURSOR START (UNUSED) — 


12 


Xc 


R DISPLAY 


13 


ADDRESS 



49 


49 


40 


40 


41 


41 


15 


15 


32 


40 


3 


5 


25 


25 


29 


33 








9 


7 














16 


16 









NOTES: 1. REGISTERS ARE WRITE-ONLY 

2. AVOID EXTREME CHANGES IN 
REGISTER, OR CRT DAMAGE 
COULD RESULT 

3. REGISTER WILL ADJUST SCAN 
TO ALLOW INTERFACING TO 
EXTERNAL MONITOR 

4. REGISTER 12, BIT 4, WILL "INVERT" 
THE VIDEO SIGNAL. 

5. REGISTER 12, BIT 5, SWITCHES TO 
AN ALTERNATE CHARACTER SET. 
THE CHARACTER SET IS NOT 
IMPLEMENTED ON MOST MACHINES 
EXCEPT SUPER-PET. 

Figure C.4 
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The 6522 VIA 



6522 









Retrace 
In 


Tape #2 
Motor 


Tape 
Output 






NRFD 
Out 






E840 


DAV In 


NRFD In 


ATN Out 


NDAC In 


59456 


E841 


Unused (See E84F) 


59457 


E842 


Data Direction Register B (for E840) 


59458 


E843 






Data Direction Re 


g 


ster A (for E84F) 










59459 


E844 








Timer 1 














59460 


E845 


























59461 


E846 








Timer 1 Latch 














59462 


E847 


























59463 


E848 








Timer 2 














59464 


E849 


























59465 


E84A 


Shift Register (unused) 


59466 


E84B 


T1 Control 


T2 Cont 


Shift 1 




jgister Control 


Latch Controls 
PB PA 


59467 


E84C 


CB2 (PUP) Control 


CB1 Cnti 
Tape#2 


CA2 Control 
Graphicsn"ext Mode 


CA1 
(PUP) 
Control 


59468 


E84D 
E84E 


Irq Stats 
tnt EnabI 


Timer 
1 

Int 


Timer 
2 
Int 


CB1 
Int 


CB2 
(PUB) 
Int 


SR 
Unused 


CA1 
(PUP) 
Int 


CA2 
GfT Mode 
unused 


59469 
59470 


E846F 






Parallel User Port Data Re< 


3IS 


Jter PA 










59471 



Figure C.5 
VIA chart 



VIC-20 

The Great Zero-Page Hunt 

Locations $FC to $FF are available. Locations $22 to $5 A, $4E to 
$53, and $57 to $bO are work areas available for temporary use. 

Most zero-page locations may be copied to another part of memory so 
that their original contents can be restored after use. However, the pro- 
grammer should take great care In modifying the following locations, which 
are critical within the operating system or BASIC: $13, $lb to $lfl, 
$5Bto $3 a, $3 ft, $53 to $5^, $bfl, $7 3 to $flft, $^0 to $qft, $ftD 
to $ft5, $Bfl to $Bft, $C5 to $F^. 
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Memory Map 



Hex 




Decimal 


Description 


□ 


-□□□5 


□- 


-5 


USE jump 


□ □□3- 


■QDQA 


3- 


-A 


Float-fixed vector 


□ □□5- 


-□□□b 


5- 


-b 


Fixed-float vector 


0007 




7 




Search character 


OOOfl 




a 




Scan-quotes flag 


□ OOR 




q 




TRB column save 


ODOR 




!□ 




0=LORD, 1=VERIFY 


ODOB 




11 




Input buffer pointer/number of 
subscripts 


OOOC 




15 




Default DIN flag 


OOOD 




13 




Type: FF = string; □□ = numeric 


OOOE 




lA 




Type: flD = integer; 
00 = f|oating point 


OOOF 




15 




DRTR scan/LIST quote/ 
memory flag 


0010 




lb 




Subscript/FNx flag 


0011 




1? 




0=INPUT; $40=GET; 
$Rfl = REfiD 


0012 




Ifl 




ATN sign/Companson 
evaluation flag 


0013 




IR 




Current I/O prompt flag 


001^- 


-0015 


2Q- 


■51 


Integer value 


001b 




55 




Pointer: temporary string stack 


0017- 


■□□Ifl 


53- 


•5^ 


Last temporary string vector 


OOIR- 


□ □51 


55- 


■33 


Stack for temporary strings 


0055- 


-□□55 


3A- 


■37 


Utility pointer area 


005b- 


■□□5fi 


3fl- 


^5 


Product area for multiplication 


005B- 


■□□5C 


A3- 


AA 


Pointer: start-of-BASIC 


005D- 


■□□5E 


AS- 


■^b 


Pointer: start-of-variables 


005F- 


•□□3D 


Al- 


■Ab 


Pointer: start-of-arrays 


0031- 


■□□35 


^q- 


•50 


Pointer: end-of-arrays 


0033- 


•003^ 


51- 


■55 


Pointer: string-storage (moving 
down) 


0035- 


•□□3b 


53- 


•5^ 


Utility string pointer 


0037- 


□ □3fl 


55- 


•5b 


Pointer: hmit-of-memory 


□ 03q- 


•□□3A 


57- 


5fl 


Current BASIC line number 


003B- 


□ □3C 


59- 


■b^ 


Previous BASIC line number 


□ 03D- 


□ □3E 


bl- 


■b5 


Pointer: BASIC statement for 
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MACHINE LANGUAGE FOR COMMODORE MACHINES 



Hex 




Decimal 


Description 






151 




Register save 


ooqa 




155 




How many open files 


aORR 




153 




Input device, normally □ 


ODRR 




15^ 




Output CMD device, normally 3 


□ ORB 




155 




Tape character parity 


aoRc 




15L 




Byte-received flag 


aORD 




157 




Direct = $ fl D/RUN = □ output 










control 


□ ORE 




15fl 




Tape pass 1 error log/character 










buffer 


aORF 




15R 




Tape pass 2 error log corrected 


aoRO- 


-□ORE 


IbO- 


-lt5 


Jiffy Clock HML 


aaR3 




lb3 




Serial bit count/EOI flag 






IhA 




Cycle count 


aORE 




lb5 




Countdown, tape write/bit count 


□ DRL 




ILL 




Tape buffer pointer 


□ OR? 




lb? 




Tape write leader count/read 










pass/inbit 


□ ORfl 




Ibfi 




Tape write new byte/read error/ 










inbit count 


aORR 




ItR 




Write start bit/read bit error/stbit 


□ □RR 




170 




Tape Scan;Cnt;Load;End/byte 










assembly 


□ ORB 




171 




Write lead length/read 










checksum/parity 


aORC- 


■aORD 


175- 


173 


Pointer: tape buffer, scrolling 


ODRE- 


■aoRF 


17^- 


175 


Tape end address/end of 










program 


OOBD- 


OOBl 


17t- 


177 


Tape timing constants 


QQB2- 


aaB3 


17fl- 


17R 


Pointer: start of tape buffer 


□ OB^ 




IflO 




1 = tape timer enabled; bit count 


OOBE 




Ifll 




Tape E0T/RS232 next bit to 










send 


□ □BL 




IflE 




Read character error/outbyte 










buffer 


OOB? 




lfl3 




Number of characters in file 










name 


□ □Bfl 




l&A 




Current logical file 


OOBR 




IflB 




Current secondary address 


□ □BR 




Ifib 




Current device 


□ □BB- 


OOBC 


lfl7- 


Iflfl 


Pointer to file name 
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Hex 




Decimal 


Description 


n n 1? 


n n z' n 
•UUh U 


b3- 




ourrGnt uhia iihg numoGr 


n n /■ 1 


n n z' D 
■U Uh c! 


bb- 


r r 
•bb 


ourrent daia aaaress 


n n z' 


n n / X 


b r - 


r A 


inpui VGCior 


n n / c; 


n nz c_ 


bH- 


•7 U 


ourreni vanaDie name 


n n / "7 


n n / A 
U Uh 


"5 1 

r 1- 


r d 


ourrern variaDie auuress 


n n X Q 
U U H n — 


n n X 7\ 


r d — 


■ r H 


varlaDie poinier TOr rUK/NriAl 


nnz R- 

U U H D 


nnz r 

U U H 


r 13 — 


7 L 
• r CD 


V-CQ\/o ■ r\ Tt - CQ\/o ■ R A Qir^ 
1-oaVU, up oaVU, DrtOlw 










I^L'll lid OClVv? 


nnz: D 




7 7 
r r 




r^om na ri cnn c\/m hnl 










am jmi ilator 




n n ^ 


7 fi- 


•fi3 


MiscGiianGOUS worK arGa, 










poiniGrs, ana so on 




n n c r 
■UUbb 


A /■ 


A r 
■fib 


Jump VGCTor lor Tunciions 


n n c ~? 


n n r n 
•U Ub U 


o7- 


o r 

■Hb 


MiscGManGOUo numeric worK 










arGa 


n n L 1 
UUb ij 




M7 




Mccumflpij exponeni 


n n r ^ 
□ Ubc!- 


n n r c 
-U Ubb 


Ho- 


1 n 1 

-lUl 


Accum#^ij. mantissa 


n n r r 
□ Ubb 








Accum#^ij. Sign 


n n r 
UU b r 




1U3 




oenes evaiuaiion consiani 










pointGr 


n n r a 
UU bo 




IUh 




Mccum^i ni-oruer ^overTiowj 


n n L a 
UUbn- 


n n L 1? 
-U U bri 


1 n c 
ij U b- 


-1 1 U 


Mccumflpc. exponeni, ana oo un 


n n IL "P 
U U br 




111 




Qinn /^r\mr\Qricr\n Ar*/^^ 1. \/orci ic 

olyn comparioun, Moc^ij verouo 










#C 


uU7 □ 




lie! 




Accum#ij to-oroGr (rounaing; 


n n ~? 1 
UU r ij- 


n n ~? D 
-U U r c 


113- 


1 1 X 

-1 iz, 


oassene Durrer lengin/serieo 










poinier 


□ □73- 


n n D 7\ 

-UUfi A 


115- 


-13fl 


CHKbhi suDrouTinG, gGt 










dAoio cnaractGr 


n n "5 7\ 
UU r A- 


n n ~? 13 
-U U r D 


1 d d- 


-led 


DACI/^ r\/Mntcir /lA/itkiirt 

DMoio poinier ^wunin 










oUDf UUTine; 


n n A 13 
UUOd- 


n n A 1? 
-U UQr 


1 — in 

13R- 


-Iz, 3 


nNJj seea vaiue 


n n Q n 
U UM U 




1^1 z. 




oiaius wora o i 


n n n 1 

UUHl 




IXC 




rvGyswiicn riA. olUr ana 










£\ V o 11 ago 


n n n ~i 

UUHd 




1 X L 
ijZ, b 




1 iming consiani lor lapG 


n n Q 

U U n J 




1^7 




1 narl — n* x/orifw — 1i 






l^fl 




SGrial output: dGfGrtGd charactGr 










flag 


DORS 




l^R 




SGria! dGfGrrGd charactGr 


ooqt 




150 




TapG EOT rGCGivGd 
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Hex 




Decimal 


Description 


□ □BD 




Iflq 




Write shift word/read input 
char 


□ □BE 








Number of blocks remaining to 
write/read 


□ □BF 




iqi 




Serial word buffer 


D^CD 








Tape motor interlock 


□ □Cl- 


-□□C2 


1R3- 


-iq^ 


I/O start address 


□ □C3- 


-QQCA 


1R5- 


-IRb 


Kernal setup pointer 


□ □C5 








Last key pressed 


□ □Ct 




iqfl 




Number of characters in 
keyboard buffer 


□ □C7 




iqq 




Screen reverse flag 


□ □Cfl 




^QQ 




End-of-line for input pointer 


D^cq- 


■QQCk 




-2^2 


Input cursor log (row, column) 


□ □CB 




EQ3 




Which key: b^ if no key 


□ □CC 




^QA 




□ = flash cursor 


□ □CD 




^□5 




Cursor timing countdown 


□ DCE 




^□b 




Character under cursor 


□ □CF 




^□7 




Cursor in blink phase 


□ □D^ 




^□fl 




Input from screen/from 
keyboard 


□ □Dl- 


•□□D2 


^□q- 


-21^ 


Pointer to screen line 


□ □D3 








Position of cursor on above line 


□ □D4 




215 




□ = direct cursor; else 
programmed 


□ □D5 




213 




Current screen line length 


□ □Db 








Row where cursor lives 


□ □D7 




215 




Last inkey/checksum/buffer 


□ □Dfl 




21t 




Number of INSERTS 
outstanding 


□ □DR- 


•□□F^ 


217" 




Screen link table 


□ □Fl 




2^1 




Dummy screen link 


□ □F2 




2^2 




Screen row marker 


DDF3- 


•□□F^ 


2^3- 




Screen color pointer 


□ □F5- 


■□□Ft 


2^5- 


-2^b 


Keyboard pointer 


□ □F7- 


•□□Ffl 


2^7- 


-2^fl 


RS-232 Rev pntr 


□ □FR- 


□ □FA 


2^q- 


•25D 


RS-232 Tx pntr 


□ □FF" 


■□!□& 


25b- 


■2bb 


Floating to ASCII work area 


□ !□□" 


•1^3E 


25b- 


■31fl 


Tape error log 


□ !□□- 


□ IFF 


25b- 


511 


Processor stack area 


□ ^□D- 


□ 55fl 


512- 




BASIC input buffer 
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Decimal 


uescnpnon 


U C 13 n 


u c □ c 


□ LJ JJ 


□ JJ LJ 




LJ □ _J 


LJ L □ 


L 1, 1, 
b ii ii - 


L pn 

- b C U 


npx/ir'P ni irnhpr t£)hlp 


n P Ln 

U C b JJ - 


n P7 L 

- U C r b 


L PI, 
b C ii - 


L ^ n 

- b J U 


occonaary aaarsss iaui6 


n P7 7 - 

U C r r 


.n P A n 
u c □ u 


L ^ 1, 
b J ii - 


Lz n 

- b *-i U 


rxcyuoara UUTTci 


n p A i.- 
Li c u ii 


n P A P 
u c u c 


□ JJ 


□ ^ 1 




U (-J _J 


LJ l_ LJ ^ 


b43- 




Ton of RAftir^ mpmorv/ 


□ 2fl5 




b *-i I] 




Serial bus timeout flag 


n P A L 

U C □ b 




a *^ □ 




ourrcni coior coae 


U l_ LJ 1 




(-.4? 




r^olor iinHpr piirQor 


(IP A A 

U (-J LJ 




□ *-l u 






(IP Aq 

LJ C. LJ n 








hi iffpr 

UUI IC?I 


n p A n 

U C (J rl 




□ _J LJ 






LJ 1 LJ U 




U -J JJ 




Rpnpflt qoppH poiintpr 


np AT 

LJ LJ 




L c; P 
b I] C 




Dpnpcit Hplfiw r»oi intpr 


np An 




L c; ^ 

b D J 




rxcyuoara snin/coniroi Tiay 


n p AP 

U C □ £i 




b -] *i 




Laoi sniTt paiicrn 


n P AT'- 


.n PQ n 


b I] I] — 


' b I] b 


rxcyuoarci lauie oc^iup poinier 


n PQi, 

U C " ii 




L c; 7 

b I] r 




rxcyiflOCIc ^IXallaCannaj 


n PQP 




m A 
b -J u 




u — scroll enauie 


U C ~ _J 








nhin nontrol 
no <c.o<c. uiiip uuruiui 






tbD 




RS-232 chiD command 






bbl- 


-bba 


Rit timino 

LJI L Lll 1 III 1^ 






tt 3 




RS-232 status 






bb^ 




Niimhpr of hit^ to ^pnH 


LJ L_ 11 


LJ 1 in 


(-.(-.^ 

U U -J 




QnppH/noHp 


LJ l_ 1 U 




□ u 1 




R^-Q'^Q rpr»pi\/P nointpr 


□ PRC 

LJ l_ 1 \rf 




L L A 
b b □ 




R^-P'^9 inniit nointpr 


n PQn 




LLP 
b b " 




no-<i.o<i. iransmii pointer 


n PCIF 

U C ~ Jj 




L7 n 
b r U 




no-^io^i: ouipui poinier 


n PQF- 


n p n n 

U C rl U 


L7 1, 
b r ii — 


L7 P 
• b r C 


xrvy save auring lape i/u 


n ^ n (1- 

U J u u 


n ^ n 1, 


7 L A 
r b O — 


7 L Q 

* r b " 


error message iiriK 


n ^ n P- 

U J u c 


.n ^ n ^ 

• U J U J 


77 ri- 

r r u ~ 


7 7 1, 


DMolo warm sian iinK 


LJ _J LJ *^ 


LJ _] U -J 


77 P- 


■ 7 7^ 
r r J 


orunun dmoio lOKens iiriK 


LJ _] LJ D 


u _j u r 


77 Z _ 
r r *i — 


• r r I] 


Print t/^l^anc llnl^ 

r nni lOKcns iinr\ 


n A- 

U _J u u — 


U J U n 


77b- 


•777 


oidn new dmoio cooe iinK 


□ 3Dft- 


□ 3DB 


77fl- 


•77q 


Get aritlnmetic element link 


□ 3DC 




7flD 




SYS A-reg save 


□ 3DD 




7fll 




SYS X-reg save 


□ 3DE 




7fla 




SYS Y-reg save 


□ 3DF 




7fl3 




SYS status reg save 
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Hex 




Decimal 


Description 


□ 314- 


□ 315 


7aa 


-7aq 


IRQ vector (EABF) 


031L- 


□ 317 


7q^- 


-7qi 


Break interrupt vector (FEDE) 


□ 31fl- 


□3iq 


7q2- 


-7q3 


NMI interrupt vector (FEAD) 


□ 31fi- 


□ 31B 




-7q5 


OPEN vector (F^^A) 


□ 31C- 


□ 31D 


7qt 


-7q7 


CLOSE vector (F34A) 


□ 31E- 


□ 31F 


7qa- 


-7qq 


Set-input vector (F2C7) 


□ 350- 


□ 321 


a^^ 


-a^i 


Set-output vector (F3^q) 


□ 3aa- 


□ 323 


a^2- 


-a^3 


Restore I/O vector (F3F3) 




□ 325 


aoA- 


-a^5 


INPUT vector (F2^E) 


□ 3at- 


□ 327 


a^t- 


-a^7 


Output vector (F27A) 


□ 3afl- 


□ 32^ 


a^a- 


-a^q 


Test-STOP vector (F7 7^) 


□ 3afi- 


□ 32B 


ai^ 


-ail 


GET vector (F1F5) 


□ 3ac- 


□ 32D 


ai2 


-ai3 


Abort I/O vector (F3EF) 


□3aE- 


□ 32F 


aiA 


-ai5 


USR vector (FED2) 


□ 33D- 


□ 331 


ait 


-ai7 


LOAD link 


□33a- 


□ 333 


aia- 


-aiq 


SAVE link 


□ 33C- 


□ 3FB 


a2a- 


-i^iq 


Cassette buffer 


□ ^□0- 


□ FFF 


1^24- 


-^□qs 


3K RAM expansion area 


!□□□- 


IFFF 


^□qt- 


-aiqi 


Normal BASIC memory 




7FFF 


aiq2 


-327t7 


Memory expansion area 




QFFF 


327ta- 


-3tat3 


Character bit maps (ROM) 




^□□F 




-3ta7q 


Video interface chip (6560) 




H12F 


3713t- 


-37151 


VIA (6522) interface-NMI 




qi2F 


37152 


-371t7 


VIA (6522) interface-IRQ 




SBFF 


37aaa- 


-3a3qq 


Alternate color nybble area 




q7FF 


3a4^^- 


-3aqii 


Main color nybble area 


&□□□- 


BFFF 


^□qt^- 


-4qi5i 


Plug-in ROM area 


€□□□- 


FFFF 


4qi52 


-t5535 


ROM: BASIC and operating 
system 
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VIC 6560 Chip 





Inter- 
lace 


Left Margin ( 


= 5) 




oo8o4 


$9001 


Top Margin ( = 25) 


36865 


$9002 


Scrn Ad 
bit 9 


# Columns ( = 


= 22) 




36866 


$9003 


bit 


# Rows ( = 23) 


Double 
Char 


36867 


$9004 




Input Raster Value: bits 8-1 




'^68(^R 


$9005 


Screen Address 
bits 13-10 


Character Address 
bits 13-10 


36869 


$9006 
$9007 


Light Pen Input 


Horizontal 
Vertical 


36870 
36871 


$9008 

$9009 


Paddle Inputs 




X 
Y 




36872 
36873 


$900A 


_ ON 




Voice 1 






36874 


$900B 
$900C 


^ ON 

ON j 




Voice 2 r- 

Frequency — 

Voice 3 


36875 
36876 


$900D 


ON 1 




Noise 






36877 


$900E 


Multi-Colour Mode ( = 0) 


Sound Amplitude 


36878 


$900F 


Screen Background Color 


Foregnd 
/Backg 


Frame Cotor 


36879 



Figure C.6 
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VIC 6522 Usage 



$9110 

$9111 
$9112 
$9113 
$9114 
$9115 
$9116 
$9117 
$9118 
$9119 
$911 A 
$91 IB 
$91 1C 
$91 ID 

$91 IE 
$91 IF 



DSR 


CTS 




DCD* 


Rr 


DTR 


RTS 


Data 


in 


in 




in 


in 


out 


out 


in 






RS-232 Interface 










or, Parallel User Port 










Unused — 


■ see $91 1 F 






DDRB (for $9110) 


DDRA (for $91 IF) 


_T1-L 
T1-H 

T1 Latch L 


RS-232 Send Speed; 
Tape Write Timing 






T1 Latch H 














_J2-L 
T2-H 


RS-232 Input timing 






Shift Register (*unused) 


T1 Control 


T2 Cnt 


Shift Reg Control 


PB LE 


PA LE 


CB2 


RS-232 Send 


CB1 C 


CA2 Tape motor Ctrl 


CA1 Ctl 








CB1: 






CA1. 




NMI- 


T1 


T2 


RS-232 
in 






Restore 
button 




ATN 


Tape 




— Joysticks 




Serial 


Serial 


out 


sense 


Button 


Left 


Down 


Up 


Data in 


Clk in 



Figure C.7 
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VIC 6522 Usage 



$9120 

$9121 

$9122 

$9123 

$9124 

$9125 

$9126 

$9127 

$9128 

$9129 

$91 2A 

$912B 

$91 2C 

$91 2D 
$91 2E 

$91 2F 



Joystk 
_Right__ 








Tape 
Out 












Keyboard Row Select 






Keyboard Column Input 


DDRB (for $9120) 


DDRA (for $9121) 


T1-L 
T1-H 

T1-L Latch 
T1-H Latch 


Cassette Tape Read; 
Keyboard & Clock 
Interrupt Timing 






T2-L 




Serial Bus Timing 






T2-H 




Tape R/W Timing 






Shift Register (*Unused) 


T1 Control 


T2 Ctrl 


Shift Register Contrl 


PB LE 


PA LE 


Serial Bus Data Out 


CB1 
ContI 


Serial Clock Line out 


CA1 
ContI 


IRQ. 


T1 


T2 


CB1:* 
SRQ in 


1 


CA1: 
Tape in 




*Unused: see $9121 



37152 

37153 
37154 
37155 
37156 
37157 
37158 
37159 
37160 
37161 
37162 
37163 

37164 

37165 
37166 

37167 



Figure C.8 
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Commodore 64: 

The Great Zero-Page Hunt: 

Locations $FC to $FF are available. Locations $55 to $56, $AE to 
$53, and $57 to $tD are work areas available for temporary use. 

Most zero-page locations may be copied to another part of memory so 
that their original contents can be restored after use. The programmer 
should take great care, however, in modifying the following locations, which 
are critical within the operating system or BASIC: $13, $lfc to $lfl, 
$5BtO $3fl, $3 A, $53 to $tfl, $73 to $flR, $HD to $HA, $AD 
to $R5, $Bfl to $BA, $C5 to $F^. 

Memory Map 



Hex 




Decimal 


Description 


□ □□□ 




□ 


Chip directional register 


□ □□1 




1 


Chip I/O; memory and tape 
control 


□ □□3- 


-□□□4 


3-A 


Float-fixed vector 


□ □□5- 


-□□□t 


5-t 


Fixed-float vector 


□ □□7 




7 


Search character 


□ □□a 




a 


Scan-quotes flag 


□ □□R 






TAB column save 


□ □□A 




ID 


D = LOAD, 1 = VERIFY 


□ □□B 




11 


Input buffer pointer/number of 
subscripts 


□ □□C 




15 


Default DIM flag 


□ □□D 




13 


Type: FF = string; 
DD= numeric 


□ □□E 




lA 


Type: aD - integer; 
D D = floating point 


□ □□F 




15 


DATA scan/LI ST quote/memory 
flag 


□ □ID 




It 


Subscript/FNx flag 


□ □11 




17 


D = INPUT;$4D = GET; 
$Ha=READ 


□ □15 




la 


ATN sign/Comparison 
evaluation flag 


□ □13 




iq 


Current I/O prompt flag 


□ □1^- 


□ □15 


5D-51 


Integer value 
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Hex Decimal Description 



n n 1 r 
U U Jj b 




D P 
C C 




rOinisr temporary siriny siaCK 


U U Jj r - 


n n 1 A 
U U Jj 


dd- 




Lasi Temporary siring vecior 


n n 1 □ 
UU Jjn- 


n n p 1 
U U c Jj 


3 c 
c p- 


■d d 


oiacK ror temporary sinngs 


n n p p 
U u c c — 


n n P c 
UUCP 


P z 
J ^1 — 


p p 
-P r 


Uliniy puiiUc^r arc^a 


n n P L 

U U C b — 


n n P n 

U U C ri 


P A 


Z P 


nlUUUOl Cil C^Ci lUl 1 1 lUIUpilUCiUUl 1 


n n p R 

U U ciJ — 


n n P p 

U U cL- 


Z P 
^1 p — 


z z 


Pnintor" ctart-nf-RAQIP 


n n ^ T\ 


n n "n x? 
U udh 


A p- 


b 


rointer. siari-OT-variaDies 


n n p "c 


n n p n 
U Ud U 


/ -) 
H f - 


/■ A 


roinier. sian-of-arrays 


n n p i 
UUd 1- 


n n p ^ 
U U d d 


^ p- 


c n 
'P U 


rointer. eno-OT-arrays 


n n ~3 ~3 


n n p /■ 
U Ud A 


b Jj- 


-p d 


rointer. siring-storage (moving 










Qownj 


n n p c 
UUp p- 


n n p r 
■U U d b 


c P 
p d - 


c y 
-PH 


uiiiiiy siring pointer 


n n p p 
U U p f - 


n n p A 
■U U d Q 


c c 
p p- 


c r 
-p b 


roinier. iimit-oi'memory 


n n p □ 
U Up n- 


n n p TV 
■U Ud A 


c P 
p r- 


C A 

- P u 


Iff Ant D A 1 1 ■ n A nil yy\ a r 

uurreni dmoiu line numoer 


n n ~i D 

□ □dB- 


n n ~i ^ 

■UUdC 


c n 
b H- 


r n 
-b U 


Previous BASIC line number 


n n p "n 


n n p "p 
■U Udri 


r 1 

b Jj- 


-b d 


rointer. dmoio statement tor 










rT\ XT T 

LUN 1 


□ □dr- 


-UU^ u 


bd- 


-b^ 


Current DATA line numDer 


n n /■ i 
U U A Jj- 


n n /■ p 
-U U A d 


b P- 


r r 
- b b 


ourreni uaih aooress 


n n /■ p 
U U A d - 


-U U A A 


b r - 


r A 

-bo 


Input vector 




-U U^ b 


bH- 


- r U 


Current variable name 






7 1- 


- r d 


Current variable address 


n n /■ n 
U U A H- 


-U U A A 


r d- 


-J r 
- f H 


variaDie pointer tor ruK/iNriAi 


n n / 12 
U U H D- 


n n / r* 
-U Uh L 


■p c 
r P- 


7 r 
- r b 


I -save, up"Save, dmoio 










pOllllc^r odvc^ 


n n /■ T\ 




r r 




oompanson symooi 










accumulator 




n n c p 
-U U p d 


P A 
f u - 


A P 
-u d 


Miscellaneous worK area, 










pointers, ana so on 


n n c /■ 
U U PH - 


n n c r 
-U U p b 


A / 


A L 
-U b 


jump vector tor tunctions 


n n c; 7 
U U p r - 


n n L n 

- U U b u 


A 7 


- 1 b 


iVlloCc^llailc^UUo ilUillc^ilO WUir\ 










area 


n n L 1 

U U b Jj 




Q P 
P r 




r\ccuf''-?r ' . eApone''t 


n n L p 

U U b C- 


n n L c 
-u U b p 


P A 

P u - 


1 n 1 

- Jj U Jj 


MCCum^F 1 . mantissa 


n n r r 
U U b b 




1 n p 
Jj U C 




ACCum^F 1 . sign 


LI LI □ 1 




JJ LI ^ 




Qpripc pv/ali latirkn mn^tflnt 
IC70 cjvaiuaLii^i 1 ouiioiaiiL 










pointer 


□□ta 








Accum#1 hi-order (overflow) 


□□ts- 


-□□tE 


1D5- 


-IID 


Accum#2: exponent, and so on 


□ □tF 




111 




Sign comparison, Acc#1 versus 










#2 






lie 




Accum#1 lo-order (rounding) 
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Hex 




Decimal 


Descnption 


□ □71- 


-□□7e 


113- 


-114 


Cassette buffer length/series 
Doinfpr 


n n 7 


.n n ft zi 

U U U rl 


JJ JJ Z] 


JJ ^ LJ 




□ □7ft- 


-□□7B 


lEE- 


-1E3 


BASIC pointer (within 
subroutinp^ 


□ □flB- 


-□□flF 




jj H J 


RtJn qppH v/pIiip 


nnqn 

LJ l—l 1 LJ 








OlCilUo WUlU O J. 


□ □HI 




IAS 




Keyswitch PI ft: STOP and 
RVS flaas 


LJ LJ It— 




jj M □ 






LJ LJ 1 _J 




1A7 




jji^clu. — LJ, vcj_j_j_y — ji 






l^fl 




Rprifll niitniit" HpfprrpH rhflrflr^tpr 

flaa 


□ □R5 




14H 




Sprial dpfprrpfl charartpr 


□ □H t 




150 




Tanp FOT rpppivpri 


□ □H7 




151 




Rpnistpr ^avp 


□ □Hfl 




15e 




Hnw mflnv nnpn filp^ 


□ □HH 




Ji ZI J 




Input device, normally □ 


n rm A 

LJ LJ 1 Xl 




ISA 






□ □RB 




Ji Zl Zl 




Tape character parity 


LJ LJ In-. 




15t 




Rv/tp-rpppiwpH fisn 


□ □HD 




Jj ^ r 




Dirpct= Sfln/RIJN = n niitniit 

L^ll — •4' LJ LJ/ JA U — LJ UUIL^UI 


LJ LJ n jj 




-11 ^ u 




hiiffpr 


LJ LJ 1 X 




15H 






□ □ft^- 


□ □ftE 


It^- 


ite 


Jlffv Clock HML 


□ □ft3 




lt3 




Serial bit count/EOI flag 


□ □ft^ 




It^ 




Cvcle count 


□ □ft5 




1. L c: 

JJ t) D 




Countdown, tape write/bit count 


LJ LJ ri □ 




1. U U 
Jj t) t) 






n n A 7 

LJ LJ xl r 




lb? 




Tanp \A/ritp IpaHor r»mmt/rQaH 

pass/inbit 


□ □ftfl 








Tans wrifp npw hvtp/ppafl 
error/inbit count 


□ □ftR 








Write start bit/read bit error/stbit 


□ □ftft 




!?□ 




Tape Scan;Cnt;Load; 
End/byte assembly 


□ □ftB 




171 




Write lead length/read 
checksum/parity 


□ □ftC- 


□ □ftD 


172- 


173 


Pointer: tape buffer, scrolling 
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Decimal 


L/iii>LrflfJUU(f 


□ □AE- 


□ □AF 


1, 7 Z — 


.1. 7 c; 

Ji r U 


Tape end address/end of 
p L y L d in 


□ □BD- 


□ □Bl 


1, 7 L 


1.7 7 
■ Ji r r 


Tape timing constants 


n n RP 


n riR^ 

U U D J 


17fl- 




Pr\inTQr" etoH" r\f tana Ki iffar 
r UirUcr . oldll UT lap6 UUTTci 






1. A n 

Jj u u 




1 = tape timer enabled: bit 

OUUiU 


□ □B5 




1. A 1. 

Jj U Jj 




Tape E0T/RSE3e next bit to 

conH 
OC^I lU 


n riRL 

U U D b) 




LAP 
JJ u c 




ncdu uridtduic^r crrur/uuiuyic 


n n R7 

U U D r 




1, A ^ 




iNumu6r Of unaraCi6rs in ni6 

lldmc 


n riR A 

U U D Q 










□ □BR 




1. A c; 




Current secondary address 


n riR li 

U U D n 




1, AL 
Jj u b) 




PiirrQnt Ha\/i/^a 


n riRR- 

U U D D 


.n riRp 

U U D 


1. A7 - 


-1. A A 
JJ u u 


r uiriicr lu Tiic ridiiic 


n riRn 




1. A q 




\A/ritP chift xAyrirH/roaH inniit r'har 


n riRT? 

U U D £1 




JJ n u 




Nil imKar rtf Klrt/^Uc ramolninn trt 

iNuiiiu6r ur uiuor\b r^iiidiniriy lu 

\A/r i to /rasH 


n riRF 

u u ij r 








Qori^l vA/nrH hiiffor 

OC^IIdl WUIU UUIlC^I 


□ □CD 




JJ 1 1 — 




Tape motor interlock 


nnn.- 


nnpp 


jj T J 




I/O Qtflrt flHHrPQQ 

1/ \^ OlCll I CILILIIC700 


U U J — 


.n npz 




JJ n □ 


rxerriei o6iup poirucr 


U U ^ -] 




1^7 




1 flct nrPQQoH 


nnru 

U U ^ t) 




1. Q A 
jj n u 




Miirnhpr nf r'hflrflr^tprc in 

IMUIIIUC^I Ul OF lOl dLrlC^r III 
L^ai/Kr^ofH Ki iff Ar 

^eyDOaici Duner 


n n P7 

U U ^ r 




Jj n n 




ocreen reverse iiag 


n nr A 

U U 




p n n 
c u u 




f^nH-/^f_lina fnr 'mm it n/^intor 

Ciiu ui'Hiie lur >iipui puiniei 


n npQ 
u u ^ " — 


n np n 
- u U ^ H 


p n i._ 

C U JJ 


prip 

cue 


Inm it /^i ironr i/^n / miAi /^^li ll^r^n^ 

inpui cursor log ^row, coiumnj 


n npR 

U U D 








vvmcn Key. b^i 11 no ^ey 


□□cc 




l_ LJ ^ 




□ = flash cursor 


no CD 




pn c; 

C U I] 




PiirQor timinn r^ni intHnvA/n 

WUI OUI III 1 III 1^ V^l^UI IlLIUWI 1 


n npF 




p riL 

c u □ 




ondrdcier unuer cursor 


n npp 
u u r 








Pi irertr in KlInL^ nktOoa 

oursor in oiin^ pnase 


□ □D^ 




I— I—I LJ 




Input from screen/from 

kpviinfl rri 

r\^y i^\^Cll LI 


□ □Dl- 


-□□DE 




■21D 


Pointer to <?rrepn linp 


□ □D3 




511 




Position of cursor on above line 


OODA 




ElE 




□ = direct cursor; else 
programmed 


□ □D5 




213 




Current screen line length 
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Hex 




Decimal 


Description 


n n n L 
U U U b 




d Jj ^ 




Row where cursor lives 


n nn"? 

u U U r 




PIC 
C Jj b 




uasi inKey/cnecKsum/DUTTer 


n nn A 

U U 1/ U 




d Jj b 




outstanaing 


n n HQ 


n n p p 
-U u r c 


d Jj r - 


D y D 
•d^ d 


ocreen line iinK iBDie 


u u r J - 


n npz 
- u u r ^ 


D y 

d^ d- 


D y y 
■d^ ^ 


ocreen coior poinier 


n mrc: 
u u r ij- 


n n p L 
-u u r b 


d^ 5- 


^ y r 
•d^ b 


tseyDoara poinier 


n n T? 
U U r r - 


n n p A 
-U U r 


^ /■ "3 
dA f'- 


^ y A 
-d^ 


Hb-^o^ Hcv pntr 


n n p p 
U U r n - 


n n p 7\ 
- U U r A 


D y a 
d^ n- 


D c n 
■d b U 


Ho-^o^ 1 X pnir 


n npp 
u u r r - 


n 1 n n 

-U Jj U fi 


dbb- 


^ r r 
■dbb 


rioaiing lo aoum worK area 


ni n n 
U Jj U u- 


1 n p 
- Jj U d ri 


d b b- 


1 A 
■d Jj 


Tape error log 


n 1 n n 
U Jj u u — 


n 1 pp 
• u Jj r r 


P C L 
d ZJ b — 


C 1 1 
-b Jj Jj 


rrocessor stacK area 


n P n n 
u c u u — 


n P c: A 


b Jj d- 


c_ n n 
-b U U 


DMolu inpui Duner 


n P c; q 
U c b n — 


n P L p 

-U c b c 


r n 1 
b U Jj - 


r 1 n 
b Jj U 


Logical Tiie taoie 


n P LP 

U C b J — 


n P L p 

' U C b ^ 


b Jj Jj- 


b d U 


uevice numDer laDie 


n P Ln 
U C b u — 


n P "p L 

■ U c r b 


b d Jj- 


•b d U 


oeconaary aoaress laoie 


n p "p 
U c r r — 


n ZD A n 

•U c U 


bd Jj- 


r y n 
•b A U 


Keyboard buffer 


n ZD A 1 
U C Q Jj — 


n ZD A D 


L / 1 
b H Jj — 


L y P 
bH c 


otart OT dAoIO memory 


U C U J 


TIP AZ 

U C U H 






1 up Of DMolo rnernory 


□ 505 




rye 
bA b 




Serial bus timeout flag 


n P A L 

U c u b 




LZ L 
b *i b 




ourreni coior cooe 


n p A7 

U C U 1 




L / 7 
bH r 




ouioi uriu6r ouiour 


n P A ft 

u c u u 




L y A 
b^ Q 




ocreen rnernory page 


n P ft Q 

u c U n 




L y Q 
b H n 




iviaximum size or Keyuoara 
Duner 


n P A 7i 

U C Q H 




L c n 

b b U 




nepeai aii Keys 


n p ft R 

U C Q D 




b b Jj 




nepeat speea counier 


n P ft p 

U [_ u 




b bd 




nepeai ueiay counier 


n p A n 




b bd 




ixeyDoaro bnin/ooniroi tiag 


n p AT? 




r c y 
b b^ 




Last snin paitern 


n p A p 
u c u r — 


n P Q n 
U c n U 


b b b — 


r c r 
b b b 


ixeyooara taoie seiup pointer 


n P Q 1 

U c " Jj 




bb f' 




iseyooara snin moae 


n P Q p 
U c "i c 




L C A 
b b 




u — scroll enaoie 


n p Q "3 
U c n d 




L C Q 
b b n 




Ho-^o^ control reg 


n pqz: 

u c n *-i 




L L n 

b b U 




no-^o^ commanu reg 


n P Q c: 
u C "1 IJ — 


n P Q L 

U C " b 


b t) Jj — 


LLP 
b b C 


Dii timing 


i—i i_ n 1 








no^o^ oictiuo 


□ ERfl 




tt< 




Number of bits to send 


□ ERS- 




tt5 




RS-232 speed/code 


□ ERB 








RS232 receive pointer 


□aqc 








RS232 input pointer 
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Hex 




Decimal 


Description 


n D □ n 
U c n U 




D D n 




DQO'^Q trcancmit nftintpr 
riO^O^ lidlloillll |JUllllc7l 


n I) Q P 




L 7 n 

b r U 




RQ9'^9 ni itni it nnintor 
RO^O^ UUl|JUl puH llc^l 


n D Q "C 

U d n r — 


n p 7\ n 
u d u 


L 7 1 
b r Jj — 


L7 P 
• b r C 


TDO cQv/a Hi irinn tsr^o I/O 
X rv oaVc; UUllil^ la|JC^ \i\J 


n p 7\ 1 

U [= Jj 




U7 P 






n p n P 




L7 Z 
b f H 




PT li 1. timor Zi r^nntrnl Inn 






L 7 C 
b r P 




PTH 1. intorriint 1 nn 


n ^ 7\ y* 
U d 




L7 L 
b r b 




CXH jj iirTier h enaDiea nay 


n p 7\ c 
U d Ab 




L 7 7 
off 




ocreSf 1 row marr\cr 


n D r* n 
U dLU- 


n p T?T? 
U dr rj 


7 nz 

r U ^1 — 


7 L L 
• r b b 


/Cnrito 7\ 


n n n 
U d U U- 


n n 1 
•U d U Jj 


7 L A- 
r b u — 


.7 LQ 
• r b P 


error messaye iiufs. 


m n P 
U d U d — 


n "3 n "3 
■ u d u d 


77 n_ 
r r U — 


.7 71. 
• r r Jj 


RAQIP u/arm ctart link 


n "3 nz 
u J Uh — 


m n c: 
■ u d u p 


7 7 P- 


-7 7 P 


Pninrh RA^IH tnkpnQ link 


n "3 n L 

U J U b — 


n "3 ri"? 
•u d u r 


77Z - 


r r P 


Print tnkonc link 


m n A 
U d u u - 


n "3 n Q 
■u d u n 


7 7 L 
r r b - 


77 7 
■ r r r 


Qtart nou/ RAQlH mde^ link 


n n 7\ 
U d U A- 


m n p 
- U d Ud 


7 7 A- 


.7 7 q 
r r p 


^at arithmotlr' olomont link 

061 arixnmeiio ^ic^rric^iu iiiir\ 


n "5 np 




7 A n 
r U 




H-ron QflwP 


n n Ti 
Ud UU 




7 ft 1. 
f u Jj 




Q V Q Y-ron cav/o 

01 J A"reg savc 


U J UIj 




7 A P 
r u d 






Ud Ur 




"PAP 
r u d 




CI V Q ctati ic ron ca\/P 
010 oldlUo rc^y baVc? 


Ud Jj U- 


■U d Jj d 


A Z 


P A C 
- r u P 


rT Q D f 1 inr'tinn iiimn /PPZA^ 

u J K Tuncuori jump \dchd} 


Ud 1 A - 


-Ud Jj P 


7 A A 


7 A Q 
- r u P 


Xrcy vector ^IjHpjjj 


U d Jj b- 


n P 1 "p 
-U d Jj r 


7 Q ri- 


-7 q 1. 

- f 1 Jj 


Rrook intprriint v/pr'tnr ^"P'F'titi^ 
Di c^cir\ If iic^i 1 upi vc^oiui jj □ □ ^ 


n "3 1 A 

U d Jj Q- 


n P 1 Q 
- u d Jj n 


7 Q P 
r P C- 


7 Q P 
- r P P 


WMT intprriint vprtnr fFT<1^7^ 


U d Jj A- 


n P 1 R 

- U d Jj D 


7 QZ_ 
r p H 


-7 q 


nPPW wprtnr ^"PPZ fl^ 


n "3 1 p 

U d Jj 


n P 1 n 

~ U d Jj U 


7^1 L- 
r ~ b 


-7 q 7 


PT O'^J'P vprtnr 

^IjwOIj vc^LrlUI ^i. I- n JJ y 


u d JjIj - 


n P 1 p 
-u d Jj r 


7 P A 
r p u - 


7 P P 


^pt-innirt wprtnr ^FPfTP^ 


n D n 
U d d U- 


n p p 1 
-U d d Jj 


Ann 
u u u - 


A n 1 

- u U Jj 


Qpt-ni itni it \/prtnr P ^ PI ^ 


n D D 
U d d d- 


n p p p 
- U d d d 


A n P 
u u c - 


-A n p 

□ UP 


Rpctnrp l/Pl wprtnr ^"PPPP^ 


n "3 P / 
U d dH - 


n p P c 
-u d c p 


A n z 

u U *i - 


A n c; 

□ UP 


Inni it x/prtnr ^"P1i^7^ 
nipul vc^oiui yr Ji zi I ) 


n D c_ 
Ud d b- 


n p p 
-U d d r 


A n L 

u U b - 


A n 7 

- u U r 


Oi itni it \/prtnr PZ\\ 


U d d 0- 


n p p □ 
-U d d n 


A n A 

U Q- 


A np 

- u U P 


Tpct-9TnP wprtnr ^"PL'Pn^ 


n D 7\ 
Ud d A- 


n P p p 
-Ud dD 


A 1 n 

Jj U - 


A 1. 1. 
- u Jj Jj 


nPT wprtnr ^"Pl. P*P^ 

oIj X veolur ^rjjpijj 


U d d L- 


n p pn 
-Ud cU 


A 1. P- 
u Jj C 


-ft 1. P 
u Jj P 


Ahnrt l/H vprtnr ^*PPPF^ 
Muuii ii\J vcoiui \r J cry 


U d dlj - 


n P P p 
-u d c r 


A 1. Z - 

LJ Jj H - 


-ft 1. 

u Jj P 


*nSR wprtnr ^F'RPiPi^ 


m "3 n 
U d d U- 


n P P 1 
- u d d Jj 


ft 1. L- 
U JJ □ 


-ft 1. 7 
u Jj r 


T Onn link iVC A^^ 


n "3 "3 p 
U d d d- 


n P P P 
- u d d d 


A 1. A. 
□ Jj u 


-ft I.R 
u Jj ~ 


VF link ^F'^'RDl 


n "3 "^p 
u d d 


n P*PR 
- u d r D 


ft Pft- 

LJ ^ U 


JJ i—i JJ 1 


Paccpttp hiiffpr 


u d H u - 


_nP7P 






llw Jl -J f 


□ 3flD- 


-□3BE 


asfc- 


-S5fl 


(Sprite I A) 


□ 3CD- 


-□3FE 




-IDEE 


(Sprite 15) 




-□7FF 




-BQA7 


Screen memory 


□ ADD- 


-RFFF 






BASIC ROM memory 



APPENDIX C 



797 



Hex 




Decimal 


Description 


flOOO 


-SFFF 


357fcfl- 




Alternative: ROM plug-in area 


ftOOO 


-BFFF 






ROM: BASIC 


ftOOO 


-BFFF 






Alternate: RftM 


COOO 


-CFFF 




-53E<7 


RftM memory, including 










alternative 


DDOO 


-D05E 


53E<fl- 


-53ES< 


Video chip (fcSfcfc) 


DADD 


-DAIC 




-543DD 


Sound chip (tSfll SID) 


DflOD 


-DBFF 




-5fc31S 


Color nybble memory 


DCOO 


-DCOF 


5Ed3E0- 


-5Ed335 


Interface chip 1, IRQ ( fc55fc 










Gift ) 


DDOD- 


-DDOF 


5t57t- 


■5t5Rl 


Interface chip 5, NMI (tSEt 










Gift) 


DOOO- 


-DFFF 


535<fl- 


535S< 


Alternative: character set 


EDDD- 


-FFFF 


573^^- 


fc5535 


ROM: operating system 


EDDD- 


-FFFF 


573<<- 


t5535 


Alternative: RftM 



CIA 1 (IRQ) (6526) Commodore 64 



$DCOO 


Paddle SEL 
A . B 








R 


Joystick 
. L . D . U 


PRA 


56320 


Keyboard Row Select (inverted) 


$DC01 










Joystick 1 


PRB 


56321 


Keyboard Column Read 


$DC02 




$FF — 


All Output 




DDRA 


56322 


$DC03 






$00 — 


• All Input 




DDRB 


56323 


$DC04 
$DC05 






Timer A 






TAL 
TAH 


56324 
56325 


$DC06 
$DC07 






Timer B 






TBL 
TBH 


56326 
56327 




















$DCOD 




Tape 
input 




Timer Interr 
B , A 


lOR 


56333 


$DCOE 


1 1 






One Out 
shot pode 


Time Timer 
PDL A 
out , start 


ORA 


56334 


$DCOF 


1 1 


,_.„j 




One Out 
shot /node 


Time Timer 
PBC B 
out , start 


CRB 


56335 



Figure C.9 
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CIA 2 (NMI) 



(6526) 



Commodore 64 



Sena! 
In 


Clock 
In 


1 \ 

Serial 
Out 


1 1 

Clock 
Out 


ATN 
Out 


RS-232 
Out 


1 1 

Video 


1 

Black 


DSR 
In 


CTS 
In 


F 


DCD* 
In 

>arallel I 


Rl* 
In 

Jser Po 


DTR 
Out 

rt 


RTS 
Out 


RS-232 
In 


In 


In 


Out 


Out Out 
$3F 


Out 


Out 


Out 


$06 For RS-232 








Tinner A 














Timer B 









RS-232 
In 



Timer 
B 



Timer 
A 



Timer 
A Start 



Timer 
B Start 



PRA 
PRB 

DDRA 

DDRB 

TAL 

TAH 

TBL 

TBH 

ICR 

CRA 

CRB 



Figure C.10 
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C64 Memory Map 



Sprite 



Sprite 
7 


6566 Video — Sprite Registers 




Sprite 



Sprite 
7 


DOOO 
nnni 


DOOE 
nnnF 


Position 


X_ 
Y 


53248 


53262 


D027 


D02E 


Color 


53287 


53294 






Sprite Bit Positions 
7 6 5 4 3 2 1 











D010 


X-position high 


53264 






D015 


Sprite Enable 


53269 






D017 


Y-expand 


53271 






UOl D 


Background Priority 


C007C 






D01C 


Multicolor 


53276 






D01D 


X-expand 


53277 






D01E 


Interrupt: Sprite collisn 


53278 






D01F 


Interrupt: Sprite/Backgrd coll 


53279 





Figure C.11 
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SID (6581) Commodore 64 



V1 


V2 


V3 








V1 V2 V3 


D400 
D401 


D407 
D408 


D40E 
D40F 


— Frequency 


L 
H 


54272 54279 54286 

54273 54280 54287 


D402 


D409 


D410 


Pulse Width 


L 


54274 54281 54288 


D403 


D40A 


D411 







H 


54275 54289 
54382 


D404 


D40B 


D412 


Voice Type 

NSE J PUL 1 SAW ^ TRI 




KEY 

1 1 1 


54276 54283 54290 






D413 


Attack 

Time 

2ms-8sec 

1 1 I 


Decay 
Time 
6ms-24sec 

1 1 1 


54277 54284 54291 


D406 


D40D 


D414 


Sustain 
level 

1 1 i 


Release time 

6ms-24sec 
1 1 1 


54278 54285 54292 








Voices 
(write only) 








Ly*+ 1 \j 








L 


54293 






D416 


Filter Frequency 


H 


54294 






D417 


Resonance 

1 1 1 


Filter voices 

1 EXT V3 V2 V1 


54295 






D418 


Passband 

V3 

OFF I HI 1 BD 1 LO 


1 


Master 

Volume 

1 1 1 


54296 



Filter & Volume 
(write only) 



D419 Paddle X 54297 

D41A . Paddle Y 54298 

D41B Noise 3 (random) 54299 

D41C Envelope 3 54300 



Sense 
(read only) 

Special voice features (TEST, RING MOD, SYNC) are 
omitted from tine above diagram. 



Figure C.12 
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Commodore PLUS/4 "TED" Chip- 
Preliminary 

At time of publication the Commodore 264 (alternatively called Plus/4) and 
a related machine, the Commodore 16, are not commercially available. 
Design details could change before commercial release. 

On the prototype units, much of zero-page is the same as for VIC and 
Commodore 64; in particular, the Basic pointers (SOB, SOV, etc.) are the 
same. 

Memory Map, Preliminary 

Much of zero-page is the same as for the Commodore 64. Some differ- 
ences, and other information: 



Hex 




Decimal 


Description 


DD73- 


■DDflA 


115- 


■13fl 


(CHARGET not present) 


DDR? 




151 




How many open files 


DDRfl 




15E 




Input device, normally □ 


DDRR 




153 




Output CUD device, normally 3 


DDAC 




17E 




Current logical file 


DDAD 




173 




Current secondary address 


DDAE 




17A 




Current device 


DDAF- 


■DDBD 


175- 


■17t 


Pointer to file name 


DDCfl- 


•DDCR 


EDD- 


■EDI 


Pointer to screen line 


DDCA 




EDE 




Position of cursor on above line 


DDCD 




EDS 




Row where cursor lives 


OOEF 




E3n 




Number of characters in 
keyboard buffer 




■D315 


7flfl- 


■7flq 


IRQ vector (CEDE) 


D31t- 


0317 


7^0- 


■7qi 


Break interrupt vector ( F^^B ) 


D31fl- 


03in 


7qE- 


■7^3 


OPEN vector (EF53) 



(Most other vectors are similar to the C64, but are two locations lower) 

050D-0505 15fl0-15fl5 US R program jump 

05DR-0515 15flS-15Rfl Logical file table 

0513-051C 15RS-13Dfl Device number table 

□ 51D-055t 13DS-131fl Secondary address table 

0557-D530 131S-135fl Keyboard buffer 

0fl0D-DBE7 50<fl-30<7 Color memory 

0C00-0FE7 3075-<071 Screen memory 
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FFOO 
FF01 
FF02 
FF03 
FF04 
FFOB 
FF06 
FF07 
FF08 
FF09 
FFOA 
FFOB 
FFOC 
FFOD 
FFOE 
FFOF 
FF10 
FF11 
FF12 
FF13 
FF14 
FF15 
FF16 
FF17 
FF18 
FF19 
FF1A 
FF1B 
FF1C 
FF1D 
FF1E 



TIMERS 



T1 
T2 
T3 



L 

_H_ 
L 
H 



L 
H 



TEST ECM BMM BLANK 



RUS OFF PAL FREEZE MCM 



ROWS 



Y-ADJUST 



COLUMNS 



X-ADJUST 



KEYBOARD LATCH 



IRQ FLAG:T3X T2 T1 LP RAST 



lER: 



T3X T2 



T1 



LP RAST 




RC 



CUR 



SOUND-VOICE 1 
VOICE 2 



VOICE 2 HI 




BACKGROUND COLORS 

i 



BRE 



VL 



H 



FFIF f^^ 



BL 



VSUB 



FF3E 
FF3F 



ROM SELECT 



RAM SELECT 



65280 
65281 
65282 
65283 
65284 
65285 
65286 
65287 
65288 
65289 
65290 
65291 
65292 
65293 
65294 
65295 
65296 
65297 
65298 
65299 
65300 
65301 
65302 
65303 
65304 
65305 
65306 
65307 
65308 
65309 
65310 
65311 

65342 
65343 



Figure C.13 
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IDDD-FFFF ^DRL-L5535 BASIC RAM memory 
flODD-FFFF 357Lfl-L5535 ROM: BASIC 
FFDD-FF3F L55flD-L53^3 TED I/O control chip 

B Series (B-128, CBM-256, etc.) 

The Great Zero-Page Hunt 

Zero page has a different meaning on the B series. There are several 
zero pages. Usually, you'll want to use values fronn bank 15 (the ROM 
bank, where system variables are kept); but if you are writing programs 
that will reside in a different bank, you'll have all of zero page (except 
locations and 1) completely at your disposal. 

If you need space in bank 15 zero page, you'll need to do some looking 
around. Addresses $Efc to $FF are not used by the system. Locations 
$50 to $5B and to $fcE are work areas available for temporary 
use. 

Most zero-page locations may be copied to another part of memory so 
that their original contents can be restored after use. The programmer 
should take great care, however, in modifying the following locations, which 
are critical within the operating system or BASIC: $lft, $1D to $1F, 
$5D to $<1, $<3, $5B, $7fl, $fl5-fl7, $SE to $ftB, ICO to $E5. 

Memory Map 

The following information applies to B systems released after April 1983, 
which contain a revised machine language monitor. (If POKE fc , : SYS 
t doesn't bring in a monitor display complete with a ''period" prompt, you 
have an incompatible version.) 

Notable features as compared to previous Commodore products include: 

— CHRGOT IS no longer in RAM. Wedge-type coding must be inserted at links 
$DEqEand$DEAD, which is likely to make the job easier. 

— BASIC vectors have "split." Now, for example, there are discrete "start of 
variables" and "end of variables," distinct from end-of-BASIC and start-of- 
arrays. Three-byte vectors (includtng bank number) are not uncommon. 

— The "jump table" at top of memory is still accessible and reasonably consistent 
with previous Commodore products. 

— Simple machine language programs will fit into the spare 1K of ROM at 
$□^□0 to $D7FF without trouble. Large programs must be implemented 
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either by plug-in memory (RAM or ROM) in bank IE or by being placed into 
another bank (preferably bank 3). Supplementary code will be needed to 
make all the coding components fit. 

The following map contains BASIC addresses specific to the B256/80; 
references to banks □ to < are also specific to that machine. Most of the 
map is of general usage, however. 



ALL BANKS: 
DDDD D 
DDDl 1 

BANK 0: Unused. 

BANK 1 : 
DDDE-FDDD E-tKBR 
FA5E-FBDD tl<<D-t<51E 

BANK 2: 

B256: 

DDDE-FFFF E-t5535 
BlEfl: 

DDDE-FFFF E-t5535 



BANK 3: (B256 only) 
DDDE-7FFF E-3E7t7 
flDDD-FFFF 3E7tfl-t5535 

BANK A : (BESt only) 
DDDE-FBFF E-t<511 

FCDD-FCFF t<51E-t<7t7 
FDDD-FFFF t<7tfl-E=5535 



BANKS 5 to 14: Unused. 



BANK 15: 






DDDE-DDD< 


E- 




DDDS-DDDfl 


5- 


a 


DDDR-DDDB 


q- 


11 


DDDC 


lE 




DDDD 


13 




DDDE 


lA 




DDDF 


15 




DDID 


It 




DDll 


17 





tSOS execution register 
tSOS indirection register 



BASIC program (text) RftM 
Input buffer area 



BASIC arrays in RftM 

BASIC variables, arrays and 
strings 

Key definitions 

Unused RftM. 

BASIC variables in RftM 

BASIC strings (top down) in 
RftM 

Unused RftM (descriptors?) 
Current KEY definitions 



USR junnp 

TI$ output elements: 
H,M,S,T 

Print Using format pointer 
Search character 
Scan-between-quotes Flag 
Input point; number of 
subscripts 

Catalog line counter 

Default DIM flag 

Type: 555= string, = integer 
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0015 




Ifi 




0013 




IS 




oniA 




50 




0015 




51 




OOlfc- 


OOlS 


55- 


55 


001ft 




5t 




ODIB- 


OOlC 


57- 


5fl 


OOID- 


OOIF 


5R- 


31 


0050- 


005B ^ 


35- 


■A3 


DD5D- 


005E 


<5- 


■At3 


005F- 


■0030 


A7- 


'A& 


0031- 


•0035 




•50 


0033- 


■003< 


51- 


•55 


0035- 


■003fc 


53- 


-SA 


0037- 


■0D3fl 


55- 


■5t 


003S- 


■0D3ft 


57- 


-5fl 


003B- 


•003C 


5S- 


-to 


0D3D- 


-003E 


tl- 


-t5 


003F- 


-00<1 


tD3- 




00<5- 


-00<3 




-fc7 




-00<5 


tfl- 




00<t- 


-00<7 


70- 


-71 


00<S- 


-OD<ft 


73- 


-7 A 


00<B- 


-00<C 


75- 


-7fc 


00<D- 


-00<E 


77- 


-7fl 


00<F- 


-0050 


7R- 


-flO 


0051- 


-0053 


fll- 


-fl3 


005^- 


-005tD 


&A- 


-flt 


0057- 


-005fl 


fl7- 


-flfl 


005ft 




SD 




005B- 


-005D 


Sl- 


-S5 


005E- 


-ooto 




-Sfc 


DDtl- 


-00tD3 


R7- 


-RS 


UOLA- 


-OOtE 


100- 


-110 


OOtiF 




111 




0070 




115 




0071 




113 




0075- 


-0075 


llA- 


-117 


007fc 




llfl 





Type: 15 fl = integer, 
= floating point 
Crunch flag 
Subscript index 

lnput=0; get=tD<; read ==155. 
Disk status work values 
Current I/O device for pronnpt 
suppress 
Integer value 
Descriptor stack pointers 
Miscellaneous work pointers 
Start-of-BASIC pointer 
End-of-BASIC pointer 
Start-of-Vanables pointer 
End-of-Variables pointer 
Start-of-Arrays pointer 
End-of-Arrays pointer 
Variable work pointer 
Bottom-of-Strings pointer 
Utility string pointer 
Top of string nnennory pointer 
Current BASIC line number 
Old BASIC line nunnber 
Old BASIC text pointer 
Data line nunnber 
Data text pointer 
Input pointer 
Variable name 
Variable address 
For-loop pointer 
Text pointer save 
Comparison symbol 
accumulator 
Function location 
Working string vector 
Function jump code 
Work pointers, values 
Exponent sign 
Acum string prefix 
Acum#1: exponent 
Accum#1: mantissa 
Accum#1: sign 
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0077 




JJ JJ 1 




DD7fl 




lED 




DD7R- 


DD7E 


lEl- 


lEt 


DD7F 




1E7 




DDflD 




lEfl 




DDfll- 


QQ&A 


lER- 


13E 


DD65- 


DDfl7 


133- 


135 


DDflfl- 


DDflR 


13t- 


137 


DDflB- 


DDflE 


13q- 


KE 


DDflF 




1A3 




DDRD- 


DDRE 


lAA- 




DDR3- 


DDR5 


IA7- 


i<q 


DDRt- 




15D- 


15E 


DDRflB 






DDRR- 


DDRB 


153- 


155 


DDRC 




15t 




DDRD 




157 




DDRE 




155 




DORF 




ISR 




ODAD 




ItD 




OOAl 




Ifcl 




DOAE 




IfcE 




DOAt- 


OOAfl 




Its 


OOAq 




ItR 




ODAA 




17D 




OOAB 




171 




DDAC- 


DDAD 


17E- 


173 


OOAE- 


00B3 


17^- 


17q 


ODB^ 




IflD 




00B5 




Ifll 




00B7- 


DOBfl 


lfl3- 


l&A 


ODBR- 


DOBA 


lfl5- 


lat 


OOBB- 


OOBC 


lfl7- 


Iflfl 


OOBD 




IflR 




DDBE 




IRQ 




DDBF 




IRl 




DOCO- 


OOCl 


IRE- 


■1R3 


OOCE- 


DDC3 


IR^- 


■1R5 


OOC^- 


DDC7 


IRt- 


■IRR 



Series evaluation constant 
pointer 

Acum#1 hi order (overflow) 
Accum#2 

Sign comparison, Acc#1 versus 
#2 

Acc#1 low-order (rounding) 
Senes, work pointers 
BASIC text pointer 
Input pointer 
DOS parser work values 
Error type number 
Pointer to file name 
Pointer: tape buffer, scrolling 
Load end address/end of 
program 

I/O start address 

Status word ST 

File name length 

Current logical file 

Current device 

Current secondary address 

Input device, normally 

Output CMD device, normally 3 

INBUF 

Keyswitch PI ft: stop key, etc. 
IEEE deferred flag 
IEEE deferred character 
Segment transfer routine vector 
Monitor register save 
Monitor stack pointer save 
Monitor bank number save 
Monitor IRQ save/pointer 
Monitor memory pointer 
Monitor secondary pointer 
Monitor counter 
Monitor miscellaneous byte 
Monitor device number 
Programmable key table 
address 

Programmable key address 
Pointers to change 
programmable key table 
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□ □ca- 


■□□CS 


EDD- 


•EDl 


Pointer to screen line 


DDCA 




EDE 




Screen line number 


DDCB 




ED3 




Position of cursor on line 


DDCC 




EDA 




D =text mode, else graphics 
mode 


DDCD 




EDS 




Keypress variable 


DDCE 




EDb 




Old cursor column 


DDCF 




ED7 




Old cursor row 


DDDD 




Eoa 




New character flag 


□ DDI 




EDS 




Number of keys in keyboard 
buffer 


□ DDE 




EID 




Quotes flag 


DDD3 




Ell 




Inert key counter 


□ □D< 




ElE 




Cursor type flag 


DDD5 




E13 




Screen line length 


DDDb 




El< 




Number of keys in "key" buffer 


□ □D7 




E15 




Key repeat delay 


DDDa 




Elb 




Key repeat speed 


□ □DS- 


■□□DA 


E17- 


■Eia 


Temporary variables 


DDDB 




EIS 




Current output character 


DDDC 




EED 




Top line of current screen 


□ DDD 




EEl 




Bottom line of screen 


DDDE 




EEE 




Left edge of current screen 


DDDF 




EE3 




Right edge of screen 


DDED 




EE< 




Keys: E 55 = none; lE7=key, 
lll = shift 


DDEl 




EES 




Key pressed: E55 = no key 


DDEE- 


•□□E5 


EEt- 


EES 


Line Wrap Bits 


□ 




55b 




Hex to binary staging area 


□ 


□ IDA 


E5b- 


■Ebb 


Numeric to ASCII work area 


DIDD- 


□ IFE 


E5b- 


■51D 


Stack area 


DIFF 




511 




Stack pointer save location 


DEDD- 


■□EOF 


51E- 


•5E7 


File name area 


DEID- 


■□EEb 


5Ea- 


■55D 


Disk command work area 


DE55- 


■□E5b 


5S7 




Miscellaneous work values for 
WAIT, etc 


□ 257 




5SS 




"Bank" value 






bDD 




Output logical file (CMD) 






^□1 




Sign of TAN 


□ E5A- 


•□E5D 


^□E- 


■bD5 


Pickup subroutine; 
miscellaneous work values 


DE5E- 


■□E7b 


bDb- 


■b3D 


PRINT USING working 
variables 
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□ EflD 


-□Efll 






□ EflE 


-□Efl3 


t^E 


-b^3 


□ Efl^ 


-□Efl5 


h^A 


-b^5 


□ Eflb 


-□Efl? 


b^t 


-b^7 


□ Eflfl 


-DEflq 


t^fl 


-b^q 


□ Efla 


-DEflB 


i.SO 


-b51 


□ EflC 


-DEAD 


b5E 


-b53 


□ EflE 


-DEAF 


hSA 


-b55 


□ ERD 


-DERI 


hSh 


-b57 


□ E^E. 


-□Eq3 


hS6 


-bsq 


□ E^^ 


-□E^B 


hhO 


-bbl 


□ E'^b 


_npq7 


l-.l-.P- 


-bb3 


□ E^fl 


-DE^q 




-bb5 


□E^a 


-□E^B 




-bb7 


□ E^C 








□ E^D- 


-□E^F 




-b71 


DEAD- 


-DEAB 


t7E- 


-b77 


□ EAb- 


-DEA? 


b7fl- 


-b7q 


□ 3DD- 


-□3D1 


7bfl- 


-7bq 


□ 3DE- 


-□303 


77^- 


-771 


□ 3D^- 


-□305 


77E- 


-773 


□ 3Dti- 


-□307 


774- 


-775 

1 1 —J 


□ 3Dfl- 


-□3Dq 


77b- 


-777 


□ 3Da- 


-□3DB 


77fl- 


-775 


□ 3DC- 


-□3DD 


7fl^- 


-7fll 


□ 3DE- 


-□3DF 


7flE- 


-7fl3 


□ 31D- 


-□311 




-7fl5 


□ 31E- 


-□313 


7flb- 


-7fl7 


□ 31^- 


-□315 


7flfl- 


-7fl5 


□ 31ti- 


-□317 


1 1 LJ 




□ 31fl- 


-□31^ 


7qE- 


-753 


□3ia- 


-□31B 




-755 


□ 31C- 


-□31D 


7qb- 


-757 


□ 31E- 


-□31F 




-755 


□ 3ED- 


-□3E1 






□ 3EE- 


-□3E3 




-e,Q3 


□ 3E^- 


-□3E5 




-e,os 


□ 3Eb- 


-□3E7 




-607 



Error routine link [fl555] 
Warm start link [flSCD] 
Crunch token link [flflCE] 
List link [flRF^] 

Command dispatch link [fl7 5^] 
Token evaluate link [RbBl] 
Expression eval link [R5C<] 
CHRGOT link [BAEC] 
CHRGET vector [BABE] 
Float-fixed vector [BAIE] 
Fixed-Float vector 
Error trap vector 
Error line number 
Error exit pointer 
Stack pointer save 
Temporary TRAP, DISPOSE 
bytes 

Temporary INSTRI bytes 

Bank offset 

IRQ vector [FBES] 

BRK vector [EEEl] 

NMI vector [FCAA] 

OPEN vector [FbBF] 

CLOSE vector [F5ED] 

Connect-input vector [F5<S] 

Connect-output vector [F5A3] 

Restore default I/O vector 

[FtAb] 

Input vector [F^RC] 
Output vector [F^EE] 
Stop key test vector [FSLB] 
GET vector [F^3D] 
Abort all files vector [Fb7F] 
Load vector [F7^t:] 
Save vector [Ffl^C] 
Monitor command vector 
EE77] 

Keyboard control vector [ED IF] 
Print control vector [ED IF] 
IEEE send LSA vector 
FE7^] 

IEEE send TSA vector 
FEflD] 
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D3E&- 


■D3Eq 




■anq 


IEEE receive byte vector 
F3Dft] 


D32ft- 


■D32B 


filD- 


■ail 


IEEE send character vector 
FEq7] 


D3EC- 


□ 32D 


aiE- 


fil3 


IEEE send untalk vector 
FEftB] 


D3EE- 


D3EF 


ai^- 


ai5 


IEEE send unlisten vector 
F2RF] 


□ 330- 


D331 


aib- 


ai7 


IEEE send listen vector 
FE3<] 


D33E- 


D333 


aifi- 


aiq 


IEEE send talk vector [FE3 0] 


D33<- 


■D33D 


aED- 


■aaq 


File logical addresses table 


□ 33E- 


□ 3^7 


a3D- 


■a3q 


File device table 


□ 3^fi- 


□ 351 




•a^q 


File secondary address table 


□ 35E- 


■D35^ 


fi5D- 


•a55 


Bottom of system memory 


D355- 


■D357 


a53- 


■a55 


Top of system memory 


D35a- 


■D35R 


a5b- 


■a5a 


Bottom of user memory 


□ 35B- 


■□35D 


a5q- 


■abi 


Top of user memory 


□ 35E 




atE 




IEEE timeout; D=enabled 


□ 35F 




ab3 




D = load; IE fi= verify 


□ 3bD 




at^ 




Number of open files 


□ 3bl 




at5 




Message mode byte 


D3b3- 


■□3fcfc 


ab7- 


•a70 


IVIiscellaneous register save 
bytes 


D3t,q 




a73 




Timer toggle 


□ 3bft- 


■□3fcB 


a7^- 


■a75 


Cassette vector (dead end) 


□ 3fcF- 


□ 371 


a7q- 


aai 


Relocation start address 


□ 375 




aa5 




Cassette motor flag (unused) 


□ 37b- 


■D377 


aab- 


•aa7 


RS-232 control, command 


D37ft 




aq^ 




RS-232 status 


D37B 




fiqi 




RS-232 handshake input 


D37C 




aqe 




RS-232 input pointer 


□ 37D 




flq3 




RS-232 arrival pointer 


□ 3aD- 


■□3fll 


flqb- 


■flq7 


Top of memory pointer 


□ 3flE 




flqfl 




Bank byte 


□ 333 




aqq 




RVS flag 


□ 3fl^ 




q^^ 




Current line length 


D3fl5 




qni 




Temporary output character 
save 


□ 3fit 




qoE 




D = normal, 555 = auto insert 


D3fl7 




qD3 




D = scrolling, 555 = no scroll 


D3flfl 




qn^ 




Miscellaneous work byte for 
screen 
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□3aq qos 

□3aa qob 

□3aB qo7 

03flc qna 

□3aD-D3aD qoq-qea 

□3ai-n3aa qEq-q3fl 

D3aB-D3B^ q3q-q^a 

□3B5-Q3Bb q^q-qsD 

□3Fa-D3Fq IDlb-lDl? 

03Fa-Q3FB iDia-iDiq 

□^□□-□7FF 1DE<-ED^7 

□flDD-DFFF ED^a-^QqS 

iDDQ-iFFF ^oqb-aiqi 

5DDD-7FFF fliqE-E37b7 
aQDD-BFFF 357E,fl-<qi51 
CDQQ-CFFF <qi5E-53E^7 
DQDD-D7CF 53E<fl-55E^7 
DaQQ-DflDl 55EqE,-55Eq7 
DaOD-DaiC 55aDfl-55fl3t 
DBGD-DBOF 5b0t^-BbD7q 

DCOD-DCDF 5b3ED-5b335 

DDDD-DDn3 5t57b-5b57q 

DEDD-DEn7 5bfl35-5bfl3q 

DFDD-DFD7 570flfl-57Dq5 

EGGD-FFFF 573^^-b5535 



Index to programmed key 

Scroll mode flag 

Bell mode flag 

Indirect bank save 

Lengths of 'key' words 

Bit mapped tab stops 

Keyboard input buffer 

■Key' word link [Eq IB] 

Restart vector 

Restart test mask 

Free RAM (reserved for DOS ) 

Reserved for plug in RAM 

Reserved for plug in DOS ROM 

Resen/ed for cartridges 

BASIC ROM 

Unused 

Screen RAM 

Video controller hSAS 

Sound interface device bSfll 

Complex interface adaptor 

Complex interface adaptor 

Asynchronous communications 
la b55i 

Tri Port Interface Adaptor 

hSES 

Tri Port Interface Adaptor 
Kernal ROM 



The above table shows contents for the link and vector addresses at $0280 
to $0295; these are taken from a recent B-128. 
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6545 CRT Controller 



D800 
55296 


D801 
55297 


Typical Value 
^Derimah 

1 1 1 ICll 1 





Hriri7nntal Total 


108 or 126 or 127 


1 


Horizontal Char DisDiaved 


80 


2 


Horizontal Svnr Position 


83 or 98 or 96 


3 


\/ Sync Width u 


15 or 10 


4 


Vertical Total 


25 or 31 or 38 


5 


Vert Total Adiust 


3 or 6 or 1 


6 


Vertical Displayed 


25 


7 


Vert Sync Position 


25 or 28 or 30 


8 


Mode 





9 


Scan Lines 


13 or 7 


10 


Cursor Start 


96 (blink) or 
or 6 (underline) 


1 1 


Cursor Fnd 


13 or 7 


12 
13 


— Display Address — 






14 
15 


H 

— Cursor Address — 

L 


Varies 
Varies 


16 
17 


u 

Light Pen In — 
L 







Most Registers are Write Only 14/15 are ReadA/Vrite 

16/17 are Read Only 
Registers 10, 14 and 15 change as the cursor moves 

Figure C.14 
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6525 Tri Port 



\JC\J\J 


NRFD 


NDAC 


EOl 


DAV 


ATN 


RFN 




CRQOp 


utoi 


Sense 


Cassette 
Motor 


Out 


ARB 


Network 
Rx 


Tx 


SRQ 


IFC 


CCQQQ 

OOO 00 


\Jn.\j£. 




DOoOh 


DE03 


Data Direction Register For DEOO 


56835 


DE04 


Data Direction Register For DE01 


56836 


DE05 


IRQ 




ACIA 


IP 


ALM 


IEEE 


PWR 


56837 


DE06 


CB 




Graphics 




IRQ 

Stack On 


56838 


DE07 


Active Interrupt Register 


56839 










6525 Tri Port 2 








UrUU 


Keyboard 


OfUOO 




Select 




DF02 


CRT 
Mode 


Keyboard Read 


57090 


DF03 


Data Direction Register for DFOO (out) 


57091 


DF04 


Data Direction Register for DF01 (out) 


57092 


DF05 


Data Direction Register for DF02 (in) 


57093 


DF06 


Unused 


57094 



Figure C.15 



Commodore 64: ROM Detail 

This type of ROM memory map is intended primarily for users who want 
to "browse" through the inner logic of the computer. It allows a user to 
disassemble an area of interest, to see why the computer behaves in a 
certain way. With the use of this map, the user will be able to identify 
subroutines that are called by the coding under study. 

I recommend against using the ROM subroutines as part of your own 
programs. They often don't do precisely what you want. They change 
locations when you move to a different machine. With rare exceptions, 
you can probably write better coding to do the job yourself. Stick with the 
kernal jump table: especially $FFD5 to output; $FFE< to get input; 
$FFE1 to check the RUN/STOP key; $FFCb and $FFCq to switch 
input and output respectively; and $FFCC to restore normal input/output. 
They are the same on all Commodore computers. 

A D D D : ROM control vectors 
A D □ C : Keyword action vectors 
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ftD52: 


Function vectors 


ADflD: 


Operator vectors 


ADRE : 


Keywords 


AIRE : 


Error messages 


A32fl : 


Error rnessage vectors 


A3b5 : 


Miscellaneous messages 


A3flA: 


Scan stack for FOR/GOSUB 


ABBfl: 


Move memory 


A3FB: 


Check stack depth 


A^Dfl : 


Check memory space 


A^35: 


Print "out of memory" 


A^37 : 


Error routine 


A^tq : 


BREAK entry 


A474 : 


Print "ready . " 


A^flD: 


Ready for BASIC 


A^qC: 


Handle new line 


A533: 


Re-chain lines 


A5tD : 


Receive input line 


A57q: 


Crunch tokens 


Abl3 : 


Find BASIC line 


ALAR: 


Perform [NEW] 


AbSE : 


Perform [CLE] 


AbflE : 


Back up text pointer 


AtqC: 


Perform [LIST] 


A7^E: 


Perform [FOR] 


A7ED: 


Execute statement 


AfllD: 


Perform [RESTORE] 


AflEC: 


Break 


AflEF: 


Perform [STOP] 


Afl31 : 


Perform [END] 


Afl57 : 


Perform [CO NT] 


Afl71 : 


Perform [RUN] 


Aafl3 : 


Perform [GO SUB] 


AflAD : 


Perform [GOTO] 


AflDE: 


Perform [RETURN] 


AflFfl: 


Perform [DATA] 


ARDb: 


Scan for next statement 


AREfl: 


Perform [IF] 


Aq3B: 


Perform [REM] 


Aq^B: 


Perform [ON] 


AqtB: 


Get fixed point number 


ARAS: 


Perform [LET] 


AAflD : 


Perform [PRINT#] 



208 MACHINE LANGUAGE FOR COMMODORE MACHINES 



AAflb : 


Perform [CMD] 


AAAD : 


Perform [PRINT] 


ABIE : 


Print string from (Y.A) 


AB3B : 


Print format character 


AB^D : 


Bad input routine 


AB7B : 


Perform [GET] 


ABAS : 


Perform [INPUT#] 


ABBF : 


Perform [INPUT] 


ABFq ; 


Prompt and input 


ACDti : 


Perform [READ] 


ACFC: 


Input error messages 


ADIE : 


Perform [NEXT] 


AD7a : 


Type match check 


ADSE : 


Evaluate expression 


AEAfl : 


Constant-pi 


AEFl ; 


Evaluate within brackets 


AEF7 : 


Check for *» ) " 


AEFF: 


Check for comma 


AFDfl : 


Syntax error 


AFK : 


Check range 


AFEa : 


Search for variable 


AFA7 : 


Set up FN reference 


AFEb : 


Evaluate [OR] 


AFE'^ : 


Evaluate [AND] 


BDlb : 


Compare 


BDfll : 


Perform [DIM] 


BDflB: 


Locate variable 


B113 : 


Check alphabetic 


BHD : 


Create variable 


BIS^ : 


Array pointer subroutine 


Bl A5 : 


Value 3E7bfl 


BIBE : 


Float-fixed 


BlDl : 


Set up array 


BEAS: 


Print "bad subscript" 


: 


Print ''illegal quantity" 


B3AC: 


Compute array size 


B37D : 


Evaluate [FRE] 


B3qi : 


Fixed-float 


n ~i n Ti ■ 


Evaluate [POS] 


B3Ab: 


Check direct 


B3B3: 


Perform [DEF] 


B3E1: 


Check fn syntax 


B3YA : 


Evaluate [FN] 
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: Evaluate [STR$] 


BA7S , 


: Calculate string vector 


BA&7 . 


: Set up string 


BAYA 


: Make room for string 


B5Eb 


: Garbage collection 


B5BD, 


: Check salvageability 


BtDb ; 


Collect string 


Bb3D : 


Concatenate 


Bt7A; 


Build string to memory 


BbA3 • 


Discard unwanted string 


BbDB : 


Clean descriptor stack 


BbEC : 


Evaluate [CHR$] 


B7DD : 


Evaluate [LEFTS] 


B7EC. 


Evaluate [RIGHTS] 


B737 , 


Evaluate [MID$] 


B7bl , 


Pull string parameters 


B77C 


: Evaluate [LEN] 


B7flE 


: Exit string-mode 


B7flB 


: Evaluate [ASC] 


B7RB 


: Input byte parameter 


B7AD 


: Evaluate [VAL] 


B7EB 


: Parameters for POKE/WAIT 


B7F7 


: Float-fixed 


BflDD 


: Evaluate [PEEK] 


B&EA 


: Perform [POKE] 


BflED 


: Perform [WAIT] 


Bfl^'^ 


: Add D . 5 


BflSD 


: Subtract-from 


Bfl53 


: Evaluate [subtract] 


BfltA 


: Evaluate [add] 


B'^^7 


: Complement FAC (floating accumulator)#1 


B'^7E 


: Print "overflow" 


Bqfl3 


: Multiply by zero byte 


BSEA 


: Evaluate [LOG] 


BAEB 


: Evaluate [multiply] 


BAB'^I 


: Multiply-a-bit 


BAac 


: Memory to FAC#E 


BAB7 


: Adjust FAC#1 and FAC#E 


BAD< 


: Underflow/overflow 


BAEE 


: Multiply by ID 


BAFq 


: + ID in floating point 


BAFE 


: Divide by ID 


BBIE 


: Evaluate [divide] 
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BB AE : 


Memorv to FRC#1 


BBC7 : 


FAC#1 to memory 


BBFC : 


FAC#E to FAC#1 


BCDC : 


FAC#1 to FAC#E 


BCIB : 


Round FRC#1 


D ^ 1— D » 


r^pt <^inn 

OIUI 1 


BC3^ : 


Evaluate FSGNl 


BCSa : 


Evaluate TAB SI 


ij ^ J u • 


Onmnarp T^AP-^Stl. tn mpmnrv 




FInflt-f iypH 




Evaluate FT NT! 


U J. — 1 • 


f^trinn to F RP 

oil II IM X fl ^ 


RD7E • 


Get ASCII diait 


JJ i-/ I— • 


Print "TN *' 

n 1 II 11 X ii ■ • 


BDCD : 


Print line number 

1 lllll ill 1 W 1 1 III •m/ W i 


BDDD : 


Float to ASCII 


BFlb ; 


Derimal constants 


BF3 A : 


TT constants 


BF71 : 


Evaluate FSORl 


RF7R " 


Fvaluatp Fnowprl 


RFR4 ■ 


Fvaluatp Fnpcral'i vpI 

L— V Cll via Lw [LX^^CL V 


RFED ■ 


Evaluate FEXPl 

Im V Cll UClLW 1 XJ J\ X. \ 


ED A3: 


Series evaluation 1 


ED5S : 


Series evaluation 2 


EDS7 : 


Evaluate FRND1 


E DF'-I : 


Kerna! calls with error checkina 

1 1 1 I^AI W^AIIw Will 1 Wl 1 V/ 1 Wl IwWtXIl l%4 


ElER : 


Perform FSYS1 

1 w 1 1 1 1 1 1 1 X 1 


E15b : 


Perform FS AVEl 


E 1 Pn ^ • 


Pprfnrm FVERTFYl 


Elba : 


Perform fLOADl 


FIRE • 


Pprfnrm rOPENl 


E1C7 : 


Perform fCLOSEl 


±J JJ U • 


Parametprs for LOAD/SAVE 

1 Cll Cll 1 1 wi^i w XJ n X// n v xj 


i-i ^ LJ □ • 


Chppk Hpfaiilt narampfprQ 
wi iw^rv udciuiL jjcii ai 1 ic;iwi 


EEDE ; 


Check for comma 


EEl^ ; 


Parameters for ooen/close 


j_j i_ □ ^ • 


Evaluate FTOSl 

1^ VCIIUCIIC? [ w J 


Xj I— □ U • 


Fvaluatp F^TNI 

V ClIUCllw [ J. ii J 


EEb^ : 


Evaluate [TAN] 


E3DE: 


Evaluate [ATN] 


E37B: 


Warm restart 


E3q^ : 


Initialize 


E3RE: 


CHRGET for zero page 
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E3BF : 


Initialize BASIC 


^AA7 : 


Vectors for $300 


: 


Initialize vectors 


EASY : 


Power-up message 


E5DD : 


Get I/O address 


E5D5 : 


Get screen size 


E5DA : 


Put/get row/column 


ESia : 


Initialize I/O 


ESAA : 


Clear screen 


E5LL : 


Home cursor 


E5LC: 


Set screen pointers 


E5AD : 


Set I/O defaults 


ESBA : 


Input from keyboard 


EL32 : 


Input from screen 


ELfl^ : 


Quote test 


ELRl : 


Set up screen print 


ELBb : 


Advance cursor 


ELED : 


R9tr9at cursor 


E7D1 : 


Back into previous line 


E71L : 


Output to screen 


Ea7C : 


Go to next line 


EflRl : 


Perform (return) 


EflAl: 


Check line decrement 


EflBa : 


Check line increment 


EflCB : 


Set color code 


EflDA : 


Color code table 


EflEA : 


Scroll screen 


ERL5 : 


Open space on screen 


ERCa : 


Move a screen line 


ERED : 


Synchronize color transfer 


ERFD : 


Set start-of-line 


ERFF : 


Clear screen line 


EA13 : 


Print to screen 


EAE^ : 


Synchronize color pointer 


EA31 : 


Interrupt-clock, etc. 


EAfl? : 


Read keyboard 


EB7R : 


Keyboard select vectors 


EBfll : 


Keyboard 1-unshifted 


EBC2: 


Keyboard 2-shifted 


ECD3: 


Keyboard 3-"Commodore" shift 


ECAA: 


Graphics/text contrl 


ECAY: 


Set graphics/text mode 


EC7a: 


Keyboard 4 
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ECBR: 


Video chip setup 


ECE7 : 


Shift/run equivalent 


ECFD: 


Screen In address low 


EDDR: 


Send "talk" to serial bus 


EDDC: 


Send "listen" to serial bus 


ED^D: 


Send to serial bus 


EDB2: 


Senal timeout 


EDBR: 


Send listen SA 


EDBE : 


Clear ATN 


EDC7 : 


Send talk SA 


EDCC: 


Wait for clock 


EDDD : 


Send serial deferred 


EDEF: 


Send "untalk" to serial bus 


EDFE : 


Send "unlisten" to serial bus 


EE13 : 


Receive from serial bus 


EEflS : 


Senal clock on 


EEflE : 


Serial clock off 


EER7 : 


Senal output "1" 


EEAD : 


Serial output "0" 


EEAR : 


Get serial in and clock signals 


EEB3 : 


Delay 1 millisecond 


EEBB: 


RS-232 send 


EFDL : 


Send new RS-232 byte 


EF2E : 


No-DSR error 


EF31 : 


No-CTS error 


EF3B : 


Disable timer 


EF^A: 


Compute bit count 


EF5R : 


RS-232 receive 


EF7E : 


Set up to receive 


EFC5 : 


Receive parity error 


EFCA: 


Recieve overflow 


EFCD: 


Receive break 


EFDD : 


Framing error 


EFEl : 


Submit to RS-232 


FDDD: 


No-DSR error 


FD17 : 


Send to RS-232 buffer 


FD^D: 


Input from RS-232 


FDflL: 


Get from RS-232 


YDAA : 


Check serial bus idle 


FDBD: 


Messages 


F12B: 


Pnnt if direct 


F13E: 


Get . . . 


Fl^E: 


. . . from RS-232 
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F157 : 


Input 


FIRR : 


Get: tape/serial/RS-232 


FICA : 


Output . . . 


FIDD : 


... TO tape 


: 


Set input device 


F25D : 


Set output device 


: 


Close file 




Find tile 


F31F : 


Set file values 


F3dF : 


Abort all files 


Fd dd . 


Restore default I/O 


Fd^ A : 


Do file open 


F3D5 : 


Send SA 


F^ GH : 


Open RS-232 


F^ HE : 


Load program 


TP C 7\ TP • 

Fzi AF . 


Print ''searching" 


FbCij : 


Print filename 


TTI c "n 3 - 


Print "loading/verifying" 


F5DD : 


Save program 


FLflF : 


Print "saving" 


FbHB : 


Bump clock 


TP r "D r* • 


Log PI A key reading 


TP r "Ti "Ti • 


Get time 


TP r /* • 

FbE^ : 


Set time 


FbED : 


Check stop key 


TP r TP "D • 

FbFB I 


Output error messages 


F7 2D : 


Find any tape header 


TP ~3 r T\ • 

Fr b A : 


Write tape header 


Tn ~i T\ n . 

FrDU : 


bet buffer address 


F7D7 : 


Set buffer start/end pointers 


F7E A : 


Find specific header 


FflDD : 


Bump tape pointer 


Ffll7 : 


Print "press play 


FflSE : 


Check tape status 


TP il il • 

Fod Q . 


Print "press record . . ." 


TP Q /* 1 • 

F Q ^ li : 


Initiate tape read 


Fflb^ : 


Initiate tape write 


Fa75 : 


Common tape code 


TP Q "n n • 
r oDU . 


Check tape stop 


FflES: 


Set read timing 




Read tape bits 


FAbD: 


Store tape characters 


FBflE: 


Reset pointer 
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FBR7 : 


New character setup 


FBfifc: 


Send transition to tape 


FBCfl : 


Write data to tape 


FBCD: 


IRQ entry point 


FC57 : 


Write tape leader 


FCR3 : 


Restore normal IRQ 


FCBfl : 


Set IRQ vector 


FCCA: 


Kill tape motor 


FCDl : 


Check R/W pointer 


FCDB: 


Bump R/W pointer 


FCEE: 


Power reset entry 


FDDE: 


Checl< fl-ROM 


FDID : 


fl-ROM masl< 


FD15 : 


Kernal reset 


FDIA: 


Kernal move 


FD3D : 


Vectors 


FD5D : 


Initialize system constants 


FDRB: 


IRQ vectors 


FDA3 : 


Initialize I/O 


FDDD: 


Enable timer 


FDFR : 


Save filename data 


FEDD : 


Save file details 


FED? : 


Get status 


FElfl . 


Flag status 


FEIC 


Set status 


FEEl 


: Set timeout 


FEES 


: Read/set top of memory 


FEE? 


: Read top of memory 


FEED 


: Set top of memory 


FE34 


: Read/set bottom of memory 


FE43 


: NMI entry 


FEbb 


: Warm start 


FEBfc 


: Reset IRQ and exit 


FEBC 


: Interrupt exit 


FECE 


: RS-232 timing table 


FEDfc 


: NMI RS-232 in 


FFD? 


: NMI RS-232 out 


If A3 


: Fake IRQ 


FF^fl 


: IRQ entry 


FFfll 


: Jumbo jump table 


FFFA 


: Hardware vectors 



D 



Character 
Sets 
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Superchart 

The "superchart" shows the PET character sets. A byte may have any of 
several meanings, depending on how it is used. The chart is constructed 
to reflect this. "ASCII" is PET ASCII; these are the characters as they 
would be input or pnnted. "Screen" is the Commodore screen codes, as 
they would be used in screen memory— POKEing to or PEE King from 
the screen would yield these codes. Notice that the numeric character set 
is the same for both screen and PET ASCII. 

Within a program, the code changes again "BASIC" shows these codes; 
they are similar to ASCII in the range $2D to $5F. 

Machine language op codes are included for the sake of convenience and 
completeness 



DECIMAL 


HEX 


ASCII 


SCREEN 


BASIC 


6502 


DECIMAL 





00 




(a 


end-line 


BRK 





1 


01 




A 




ORA(!,X) 


1 


2 


02 




B 






2 


3 


03 




C 






3 


4 


04 




D 






4 


5 


05 


white 


E 




OPAZ 


5 


6 


06 




F 




ASLZ 


6 


7 


07 


bell 


G 






7 


8 


08 


lock 


H 




PHP 


8 


9 


09 


unlock 


1 




ORA # 


9 


10 


OA 




J 




ASL A 


10 


11 


OB 




K 






11 


12 


OC 




L 






12 


13 


OD 


car ret 


M 




ORA 


13 


14 


OE 


text 


N 




ASL 


14 


15 


OF 


top 









15 


16 


10 




P 




BPL 


16 


17 


11 


cur down 


Q 




ORA(l),Y 


17 


18 


12 


reverse 


R 






18 


19 


13 


Cur honne 


S 






19 


20 


14 


delete 


T 






20 


21 


15 


del line 


U 




ORA Z,X 


21 


22 


16 


ers begin 


V 




ASL Z,X 


22 


23 


17 




w 






23 


24 


18 




X 




CLC 


24 


25 


19 


scr up 


Y 




ORA Y 


25 


26 


1A 




z 






26 


27 


1B 




[ 






27 


28 


1C 


red 


\ 






28 


29 


ID 


cur right 


] 




ORAX 


29 
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ECIMAL 


HEX 


ASCII 


SCREEN 


BASIC 


6502 


DEC 


30 


' 1E 


green 


T 




ASL X 


30 


31 


1F 


blue 








31 


32 


20 


space 


space 


space 


JSR 


32 


33 


21 




1 


1 


AND(I,X) 


33 


34 


22 










34 


35 


23 


# 


# 


# 




35 


36 


24 


$ 


$ 


$ 


BITZ 


36 


37 


25 


% 


% 


% 


ANDZ 


37 


38 


26 


& 


& 


& 


ROLZ 


38 


39 


27 


' 


' 


' 




39 


40 


28 


( 


( 


( 


PLB 


40 


41 


29 


) 


) 


) 


AND # 


41 


42 


2A 


* 


* 


* 


ROL A 


42 


43 


2B 




+ 






43 


44 


2C 








BIT 


44 


45 


2D 


- 


- 


- 


AND 


45 


46 


2E 








ROL 


46 


47 


2F 


/ 


/ 


/ 




47 


48 


30 











BMI 


48 


49 


31 


1 


1 


1 


AND(I),Y 


49 


50 


32 


2 


2 


2 




50 


51 


33 


3 


3 


3 




51 


52 


34 


4 


4 


4 




52 


53 


35 


5 


5 


5 


AND Z,X 


53 


54 


36 


6 


6 


6 


ROL Z,X 


54 


55 


37 


7 


7 


7 




55 


56 


38 


8 


8 


8 


SEC 


56 


57 


39 


9 


9 


9 


AND Y 


57 


58 


3A 








CLI 


58 


59 


3B 


, 








59 


60 


3C 


< 


< 


< 




60 


61 


30 


= 


= 


= 


AND X 


61 


62 


3E 


> 


> 


> 


ROLX 


62 


63 


3F 


9 


9 


9 




63 


64 


40 


(aj 


H 


^ 


RTI 


64 


65 


41 


A 


1 a 


A 


EOR(l,X) 


65 


66 


42 


B 


IE, b 


B 




66 


67 


43 


C 


e.c 


C 




67 


68 


44 


D 


H, d 


D 




68 


69 


45 


E 


H,e 


E 


EORZ 


69 


70 


46 


F 


a f 


F 


LSRZ 


70 


71 


47 


G 


OO g 


G 




71 


72 


48 


H 


[B. h 


H 


PHA 


72 


73 


49 


1 


E. 1 


1 


EOR# 


73 


74 


4A 


J 


ffl J 


J 


LSR A 


74 


75 


4B 


K 


a. k 


K 




75 


76 


4C 


L 


Q, 1 


L 


JMP 


76 


77 


4D 


M 


S, m 


M 


EOR 


77 


78 


4E 


N 


\l, n 


N 


LSR 


78 
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DECIMAL 


LJ C V 

nbX 


AoL/ll 


QPRPPM 


RA*=i!r: 


6502 


DECIMAL 


79 


4F 


o 


D, 


u 




7Q 


80 


50 


P 


PI r\ 

□ P 


D 


PMC. 

D V 




81 


51 


Q 


[1, Q 






R1 


82 


52 


H 


[U r 


Q 

n 






83 


53 


o 
o 


If), s 


Q 
o 




R3 


84 


54 


T 

1 


iri t 


T 
1 




84 


85 


55 


1 1 

U 


rj •■ 
Lc, u 


1 1 
U 


FOR 7 y 
cwn, ^,A 


R5 


86 


56 


V 


V 


V 


1 QR 7 Y 
Lon Z.,A 


RR 
OD 


87 


57 


W 


|0J, w 


w 




R7 


88 


CD 

oo 


V 
A 


□e). X 


y 

A 


CI 1 


88 


89 


59 


Y 


u. y 


V 
T 


FOR Y 


RQ 


90 


5A 


Z 


iTl, z 


z. 






91 


trD 

5B 


[ 


m 


r 
I 




91 


92 


oO 


V 

\ 








92 


93 


OU 


1 

J 


rr 


1 


EOR X 


93 


94 


5E 


T 




1 


1 «^R X 


94 


95 


5F 




[5, sa 








96 


60 








n 1 o 


QR 


97 


61 




■J 




r\uv_/^i, A^ 


97 


98 


62 




□ 
m 






98 


99 


63 




U 






QQ 


100 


64 




u 








101 


65 




U 






1 ni 


102 


66 




RH 




ROR 7 


102 


103 


67 




n 






103 


104 


68 




rn 




PI A 


1 


105 


69 




E, 6SS 




ARP :ik 


1 nf> 


106 


6A 




1 

I J 




ROR A 


1 0R 


107 


CD 

bb 




ru 
Lb 






107 


108 


bO 




rj 




JIVIr ^1^ 


108 


109 


6D 




rc 

n 




ARP 


1 HQ 


1 10 


6E 




hi 




RnR 


1 1 u 


111 


6F 




1 1 
U 






111 


112 


70 




rj 

Lb 




n V o 


1 12 


1 13 


71 




tli 

n 




ARP^h Y 


1 13 


114 


72 




r n 

nc 






114 
1 1 1 


115 


73 




nJ 






1 1 

1 1 o 


116 


74 




n 
LI 






1 ifi 


117 






U 




ARP 7 X 


117 


118 


76 




n 
U 




ROR 7 y 


1 1R 


119 


77 




□ 






1 1 Q 
1 1 c/ 


120 


78 




n 




CFI 
oti 




1 21 


79 








ARP Y 


121 


122 


7A 










122 


123 


7B 










123 


124 


7C 




[3 






124 


125 


7D 








ADCX 


125 


126 


7E 




C 




ROR X 


126 


127 


7F 




s 






127 
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UtL/IIVlAL 


nbX 


ASCII 


SCREEN 


BASIC 


6502 


DECIMAL 


128 


OA 

80 




r-(a 


END 




128 


1 2y 


81 


orange 


r-A 


FOR 


STA(I,X) 


129 


1 OA 


82 




r-B 


NEXT 




130 


lOl 


83 




r-C 


DATA 




131 


1 62. 


84 




r-D 


INPUT# 


STY Z 


132 


1 J J 


85 




r-E 


INPUT 


STAZ 


133 


1 o4 


86 




r-F 


DIM 


STX Z 


134 


135 


87 




r-G 


READ 




135 


1 36 


88 




r-H 


LET 


DEY 


136 


1 37 


89 




r-l 


GOTO 




137 


1 Jo 


8A 




r-J 


RUN 


TXA 


138 


1 Jy 


8B 




r-K 


IF 




139 


1 40 


8C 




r-L 


RESTORE 


STY 


140 


141 


8D 


car ret 


r-M 


GOSUB 


STA 


141 


1 42 


St 


graphic 


r-N 


RETURN 


STX 


142 


1 4 J 


8F 


bottom 


r-0 


REM 




143 


1 44 


90 


black 


r-P 


STOP 


BCC 


144 


145 


91 


cur up 


r-Q 


ON 


STA(I), Y 


145 


1 4b 


92 


rvs off 


r-R 


WAIT 




146 


147 


93 


clear 


r-S 


LOAD 




147 


148 


94 


insert 


r-T 


SAVE 


STY Z,X 


148 


1 49 


95 


ins line/br 


r-U 


VERIFY 


STA Z,X 


149 


1 OO 


96 


ers end/p 


r-V 


DEF 


STX Z,Y 


150 


151 


97 


Gray 1 


r-W 


POKE 




151 


1 CO 


98 


Gray 2 


r-X 


PRINT# 


TYA 


152 


1 53 


99 


scr. down 


r-Y 


PRINT 


STAY 


153 


154 


9A 


L Blue 


r-Z 


CONT 


TXS 


154 


1 cc 
1 00 


9B 


Gray 3 


r-[ 


LIST 




155 


156 


9C 


magenta 


r-\ 


CLR 




156 


1 Of 


9D 


cur left 


r-] 


CMD 


STA X 


157 


1 58 


9E 


yellow 


r-T 


SYS 




158 


159 


9F 


cyan 




OPEN 




159 


1 60 


AO 




■ 


CLOSE 


LDY # 


160 


161 


A1 


f] 


r-' 


GET 


LDA(I,X) 


161 


ICO 

1 b2 


A O 

A2 


1 — 1 
y 


r-" 


NEW 


LDX # 


162 


163 


A3 


n 


r-# 


TAB( 




163 


164 


A4 


□ 


r-$ 


TO 


LDYZ 


164 


165 


A5 




r-% 


FN 


LDAZ 


165 


166 


A6 




r-& 


SPC( 


LDXZ 


166 


167 


A7 


J 


r-' 


THEN 




167 


168 


A8 




r-( 


NOT 


TAY 


168 


169 


A9 




r-) 


STEP 


LDA # 


169 


1 /U 


A A 

AA 


n 


r-* 


+ 


TAX 


170 


171 


AB 


m 


r- + 






171 


172 


AC 


[i 


r-, 




LDY 


172 


173 


AD 


ffl 


r- 


/ 


LDA 


173 


174 


AE 


ffl 


r-. 


T 


LDX 


174 


175 


AF 


u 


r-/ 


AND 




175 


176 


80 


ffl 


r-0 


OR 


BCS 


176 
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DFPIMAI 


HEX 


ASCII 


SCREEN BASIC 


6502 


DECIMAL 


177 


B1 




r-1 > 


LDA(I),Y 


177 


1 78 


B2 




r-2 




178 


179 


B3 


S] 


r-3 < 




179 


180 


B4 


D 


r-4 SGN 


LDY Z,X 


180 


181 


B5 




r-5 INT 


LDA Z,X 


181 


182 


86 


□ 


r-6 ABS 


LDx zy 


182 


183 


B7 


n 


r-7 USR 




183 


1 ot 


B8 


m 

LJ 


r-8 FRE 


CLV 


184 




B9 


n 


r-9 POS 


LDA Y 


185 


186 


BA 


□ ¥i 


r-. SQR 


rsx 


186 


187 


BB 


u 


r-, RND 




187 


1 oo 


BC 




r-< LOG 


LDY X 


188 


IRQ 


BD 


r 1 


r- = EXP 


LDA X 


189 


1 90 


BE 


ri 

lj 


r-> COS 


LDX Y 


190 


191 


BF 




r-'? SIN 




191 


192 


CO 


g 


TAN 


CPY# 


192 


193 


CI 


M a 


ATN 


CMP(I),X 


193 


194 


C2 


H b 


PEEK 




194 


195 


C3 


B c 


LEN 




195 


196 


C4 


H d 


STR$ 


CPY Z 


196 


197 


05 


e 


VAL 


CMPZ 


197 


198 


C6 


S f 


ASC 


DEC Z 


198 


199 


C7 


OO g 


CHR$ 




199 


200 


C8 


CE h 


LEFTS 


INY 


200 


201 


C9 


E ' 


RIGHTS 


CMP # 


201 


202 


CA 




MID$ 


DEX 


202 


203 


CB 


S k 


GO 




203 


204 


CO 


U 1 


CONCAT 


CPY 


204 


205 


CD 


S m 


DOPEN 


CMP 


205 


206 


CE 


^. n 


DCLOSE 


DEC 


206 


207 


CF 


C. 


RECORD 




207 


208 


DO 




HEADER 


BNE 


208 


209 


D1 


l. q 


COLLECT 


CMP(I),Y 


209 


210 


D2 


Q, r 


BACKUP 




210 


21 1 


D3 


11 s 


COPY 




211 


212 


D4 


C t 


APPEND 




212 


213 


D5 


ffl u 


DSAVE 


CMP Z,X 


213 


214 


D6 


K V 


DLOAD 


DEC Z,X 


214 


215 


D7 


H w 


CATALOG 




215 


216 


D8 


I5i X 


RENAME 


CLD 


216 


217 


D9 


Lii y 


SCRATCH 


CMP Y 


217 


218 


DA 


ffl z 


DIRECTORY 




218 


219 


DB 








219 


220 


DC 


EJ 






220 


221 


DD 


[E 




CMP X 


221 


222 


DE 


[i ^ 




DEC X 


222 


223 


DF 




i 




223 


224 


EO 




m 


CPX# 


224 


225 


El 




u 


SBC(I),X 
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DECIMAL 


HEX 


ASCII 


SCREEN BASIC 


6502 


DECIMAL 


226 


E2 




E 




226 


227 


E3 




m 




227 


228 


E4 




■ 


CPX2 


228 


229 


E5 




■ 


SBC 2 


229 


230 


E6 






INC 2 


230 


231 


E7 




p 




231 


232 


E8 




a 


INX 


232 


233 


E9 




a ^ 


SBC # 


233 


234 


EA 




n 


(MOP 


234 


235 


EB 




D 




235 


236 


EC 




Fi 


CPX 


236 


237 


ED 




B 


SBC 


237 


238 


EE 




a 


INC 


238 


239 


EF 




i 




239 


240 


FO 




E 


BEQ 


240 


241 


F1 




ca 


SBC(I), Y 


241 


242 


F2 




B 


242 


243 


F3 




n 




243 


244 


F4 




1 




244 


245 


F5 




1 


SBC 2,X 


245 


246 


F6 




n 


INC 2,X 


246 


247 


F7 




i 




247 


248 


F8 




H 


SED 


248 


249 


F9 




H 


SBC Y 


24Q 


250 


FA 




1 a 




250 


251 


FB 




a 




251 


252 


FC 




B 




252 


253 


FD 




a 


SBCX 


253 


254 


FE 




a 


INCX 


254 


255 


FF 








255 
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Control Character Representations 



Ml II 


Ml ill 

Null 


SOH 


Start of Heading (CC) 


O 1 A 


otart of Text (CC) 


ETX 


End of Text (CC) 


LU 1 


End of Transmission (CC) 


ENQ 


Enquiry (CC) 


ACK 


Acknowledge (CC) 


BEL 


Bell 


D O 

DO 


Backspace (FE) 


HT 


Horizontal Tabulation 




(FE) 


LF 


Line Feed (FE) 


VT 


Vertical Tabulation (FE) 


r— r— 


Form Feed (FE) 


— > Un 


o KKi oo/^ Da^i lien 

uarnage neiurn trt; 


so 


Shift Out 


SI 


Shift in 


(CC) 


Communication Control 


(FE) 


Format Effector 


(IS) 


Information Separator 



DLE 


Data Link Escape (CC) 


DC1 


Device Control 1 


DC2 


Device Control 2 


DC3 


Device Control 3 


DC4 


Device Control 4 


NAK 


Negative Acknowledge (CC) 


SYN 


Synchronous Idle (CC) 


ETB 


End of Transmission Block 




(CC) 


CAN 


Cancel 


EM 


End of Medium 


SUB 


Substitute 


ESC 


Escape 


FS 


File Separator (IS) 


GS 


Group Separator (IS) 


RS 


Record Separator (IS) 


US 


Unit Separator (IS) 


DEL 


Delete 



Figure D.I 



Special Graphic Characters 



^SP 


Space 




Less Than 




Exclamation Point 




Equals 




Quotation Marks 


> 


Greater Than 


^# 


Number Sign 


? 


Question Mark 


^$ 


Dollar Sign 




Commercial At 


^% 


Percent 




Opening Bracket 


^& 


Ampersand 




Reverse Slant 




Apostrophe 




Closing Bracket 


^( 


Opening Parenthesis 




Circumflex 




Closing Parenthesis 




Underline 


* 


Asterisk 




Grave Accent 


+ 


Plus 


{ 


Opening Brace 




Comma 




Vertical Line (This graphic 




Hyphen (Minus) 




IS sometimes stylized to 




Period (Decimal Point) 




distinguish it from the un- 




Slant 




broken Logical OR which 




Colon 




is not an ASCII character) 




Semicolon 


} 


Closing Brace 



Tilde 



Characters marked correspond to the PET ASCII character set. 
Figure D.2 
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ASCII 

ASCII is the American Standard Code for Information Interchange. It is 
the standard for communications, and is often used with non-Commodore 
printers. 

When a Commodore machine is in its graphic mode, its character set 
corresponds closely to ASCII. Numeric, upper case alphabetic, and punc- 
tuation characters are the same A few control characters, such as 
RETURN, also match. Commodore graphics have no counterpart in ASCI I. 

When the Commodore machine is switched to text mode, the character 
set diverges noticeably from ASCII. Numeric characters and much of the 
punctuation corresponds, but ASCII upper case alphabetic codes match 
the Commodore computer's lower case codes. Commodore s upper case 
alphabetics are now completely out of the ASCII range, since ASCII is a 
seven-bit code 

As a result, Commodore's PET ASCII codes require conversion before 
transmission to a true ASCII device or communications line. This may be 
done with either hardware interfacing or with a program. Briefly, the pro- 
cedure is: 

1 . If the Commodore character is below $3F, it may be transmitted directly to 
the ASCII facility. 

2. If the Commodore character is between and $5F, it should be logically 
ORed with $ED (or add decimal 3E) before transmission to ASCII 

3. If the Commodore character is between $CD and $DF, it should be logically 
ANDed with $7F (or subtract decimal lEa)before transmission to ASCII. 

Equivalent rules can be derived to allow a Commodore computer to receive 
from ASCII. For either direction of transmission, some control characters 
may require special treatment. 
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First Hexadecimal Digit 








1 


2 


3 


4 


5 


6 


7 





NUL 


DLE 


SP 





@ 


P 




P 


1 


SOH 


DCI 


! 


1 


A 


Q 


a 


q 


2 


STX 


DC2 




2 


B 


R 


b 


r 


3 


ETX 


DC3 


# 


3 


C 


S 


c 


s 


4 


EOT 


DC4 


$ 


4 


D 


T 


d 


t 


5 


ENQ 


NAK 


% 


5 


E 


U 


e 


u 


6 


ACK 


SYN 


& 


6 


F 


V 


f 


V 


7 


BEL 


ETB 




7 


G 


w 


g 


w 


8 


BS 


CAN 


( 


8 


H 


X 


h 


X 


9 


HT 


EM 


) 


9 


1 


Y 


1 


y 


A 


LF 


SUB 


* 




J 


z 


j 


z 


B 


VT 


ESC 


+ 




K 


[ 


k 


{ 


C 


FF 


FS 




< 


L 


\ 


1 


1 
1 


D 


CR 


GS 






M 


] 


m 


} 


E 


SO 


RS 




> 


N 




n 




F 


SI 


US 


/ 


? 










DEL 



ASCII code values. 
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From Chapter 6: 

VIC-20 (Unexpanded) Version 

We write the BASIC program as follows: 

!□□ V%=U 

IID F0RJ = 1T0 5 

lED INPUT "VALUE" 

13U SYS + + + + 

lAU PRINT "TIMES TEN = " ; V? 

15D NEXT J 

Plan to start the machine language program at around ^DST + lET.or 
AEEA (hexadecimal IDflD). On that basis, we may change line 13D to 
SYS ^55^. Do noMry to run the program yet. 



7\ 1 n A n 

. H Jj U Q u 


L JJ I 






7\ 1 n A P 

• H Jj U Q c 


T n li 


{ ^>CU ) t 


V 


7\ 1 n A z 

- H Jj U Q M 


o 1 H 






7\ 1 n A "P 

. H Jj U Q r 


o 1 H 


<t: n "3 "3 p 




• H Jj U Q H 


Li U I 


9r 4> LIJ 




A 1 n A P 
. Jj U Q 


Li JJ H 


/ <t p n \ 
( 4>c: JJ ; / 


V 
I 


A 1 n AP 
. H Jj U Q IL 


c fp A 
o L H 


<c n T n 

4> UJ J JJ 




n 1 n Q 1. 

. fi Jj U n Jj 


C rp A 
O L ri 


<t; n ^ ^ p 
4> L) J J r 




• ft lUM^ 


asL 


(t n u 




.a ins? 


ROL 


$□330 




.a inqa 


asL 


$□330 




.a IQRD 


ROL 


$□330 




.a inan 


CLC 






.a inai 


Loa 


$□330 




.a lUAA 


aoc 


$□33? 




.a ina? 


STA 


$□330 




.a inaa 


Loa 


$□330 




.a inao 


aoc 


$^33E 




.a IQBQ 


STa 


$D33C 




.a inB3 


asL 


$□330 




.a inBb 


ROL 


$□330 




.a iDsq 


LDY 


#$□5 




.a IQBB 


LDA 


$□330 




.a IQBE 


STA 


($E0) 


,t 


.a IQCQ 


LDY 


#$□3 




.a IQCE 


Loa 


$□330 




.a inc5 


STa 


($eo) 


,Y 


. a 1DC7 


RTS 
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To change the start-of-variables pointer to a location above the machine 
language program, display the SOV pointer with .M DDHD DDHE and 
change the pointer to 

. :DD5D Cfl ID 

PET/CBM Version 

We write the BASIC program as follows: 

!□□ V%=D 

IID F0RJ=1T0 5 

15D INPUT "VALUE" 

13D SYS + + + + 

l^D PRINT "TIMES TEN =" :V% 

15D NEXT J 

Plan to start the machine language program at around lD55 + lE7,or 
115E (hexadecimal AbU). On that basis, we may change line 13D to 
SYS 1155. Do nof try to run the program yet. 



.A UA&D 


LDY 


#$□5 


. A UA&B 


LDA 


($5A) ,Y 


.A OA&A 


STA 


$Q33C 


.kDA&7 


STA 


$D33E 


. A D^flA 


LDY 


#$□3 


. A D^ac 


LDA 


($5A) ,Y 


.A D^flE 


STA 


$D33D 


. A UAm 


STA 


$D33F 


.A DA^A 


ASL 


$D33D 


.A D^q? 


ROL 


$D33C 


. A D^qA 


ASL 


$D33D 


.A UA^D 


ROL 


$D33C 


.A DAAO 


CLC 




. A D^Al 


LDA 


$D33D 


. A D^A^ 


ADC 


$Q33F • 


.A D^A? 


STA 


$D33D 


. A D^AA 


LDA 


$D33C 


.A D^AD 


ADC 


$D33E 


.A D^BD 


STA 


$D33C 


.A nAB3 


ASL 


$D33D 


.A UABh 


ROL 


$D33C 


.A D^Bq 


LDY 


#$□5 


. A D^BB 


LDA 


$D33C 


.A D^BE 


STA 


($5A) ,Y 
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.A DACn LDY #$D3 
.ADAC^ LDA $0330 
.ADACS STA ($EA),Y 
.knAC7 RTS 

To change the start-of-variables pointer to a location above the machine 
language program, display the SOV pointer with .M DDEA DDEB and 
change the pointer to 

. : DDEA Ca 

From Chapter 7: 

An Interrupt Project 

VIC-20 (Unexpanded) Version 

The only difference with the VIC-20 is that the screen is located at $ 1 E □ □ : 

.A D33C LDA $^1 
.A □33E STA $1EDD 
.A 03^1 JMP ( $n3An) 

To place the link address into $03 AD/1: 

.A D3AA LDA $□31'^ 
.A 03^7 STA $n3An 
. A □3^A LDA $D315 
.A □3^D STA $n3Al 

To fire up the program: 

. A D35D SEX 

. A 0351 LDA #$3C 

. A 0353 STA $D31^ 

.A 035^ LDA #$D3 

.A D35fl STA $D315 

.A □35B CLI 

.A DISC RTS 

To restore the original interrupt: 

• A □35D SEI 

.A □35E LDA $D3An 
.A 03^1 STA $D31^ 

• A 03^^ LDA $D3A1 
.A □3fc7 STA $D315 
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-A D3bA CLI 
.A D3hB RTS 

SYS flBbwill invoke the new interrupt code, SYS flbl will turn it off. As 
with the Commodore 64, there is a possibility of the character printing 
white-on-white, so that it cannot be seen. 



PET/CBM Version 

This version is not for original ROM machines, which have the I RQ vector 
located at address $UEm/A: 

.A 0330 LDA $18 
.A D33E STA $&DUU 
.A 03^1 JMP ($n3aD) 

To place the link address into $D3ftD/l: 

.A n3AA LDA $DDqn 

. A D3A7 STA $n3an 

. A D3^A LDA $DDqi 
.A D3^D STA $D3ai 

To fire up the program- 

.A D3Sn SEI 

.A 0351 LDA #$3C 

.A D353 STA $nU^U 

.A 035^ LDA #$D3 

.A D3S& STA $DDqi 

. A D35B CLI 

.A D35C RTS 

To restore the original interrupt: 

. A □35D SEI 

.A D35E LDA $n3an 

.A □3bl STA $UU^U 

.A 03^^ LDA $n3ai 

. A 03^7 STA $Dnqi 
.A D3bA CLI 
.a 03^8 RTS 

SYS &3h will invoke the new interrupt code; SYS flbl will turn it off. 
Since the PET/CBM does not have colors, the characters will always show. 
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Project: Adding a Command 

PET/CBM Version 

It's not possible to write a comparable program to add a command to the 
PET/CBM. This machine doesn't have a "link" neatly waiting for us at 
address $D3na/R. Equivalent code would need to be somewhat longer 
and less elegant. 

The equivalent program for PET/CBM won't be given here. It would involve 
writing over part of the CHRGET program (at $□□?□ to SDDfl?), sup- 
plying replacement code for the part we have destroyed, and then adding 
the new features. 



F 

Floating 
Point 
Representation 
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Packed: 5 bytes (as found in variable or array) 



Zero Mantissa (value) 

Flag/ 4 bytes 

Exponent 

High bit represents sign of mantissa 

Unpacked: 6 bytes (as found in floating accumulator) 



1 









ZF/ Sign 

^''P*'"^"' Mant.ssa-4 Bytes ^^'f^" 

der 

Bit only) 

• If exponent - 0, the whole number is zero 

• If exponent > $80, the decimal point is to be set as many places to the 
right as the exponent exceeds $80. 

• Example: Exponent: $83 mantissa* 11000000 . binary set the point 
three positions over: 1 10.000 ... to give a value of 6. 

• If exponent < - $80, the number is a fraction less than 1. 

Exercise: Represent +27 in Floating Point 

27 decimal = 1 101 1 binary; mantissa - 1 101 1000 ... the point is to be 
positioned 5 places in (11011 000 . . .) so we get: 
Exponent: $85 mantissa: 11011 000 . . . binary or D8 00 00 00 hexadecimal 
To pack, we replace the first bit of the mantissa with a sign bit (0 for 
positive) and arrive at: 



fl5 5fl □□ □□ □□ 



G 



Uncrashing 



It's best to write a program that doesn't fail (or "crash"). Not all of us 
succeed m doing this. 

If a program gives trouble, it should be tested using breakpoint techniques. 
The BRK (break) instruction is inserted at several strategic points within 
the program. The program stops (or "breaks") at these points, and the 
programmer has an opportunity to confirm correct behavior of the program 
at selected points. Using this technique, a fault can be pinned down quite 
closely. 

Occasionally, usually because of bad planning, a program crashes and 
the cause of the crash cannot be identified. Worse still, a lengthy program 
crashes and the user has forgotten to save a copy of it; the user is then 
faced with the task of putting it in all over again. 

In such cases, uncrashing techniques are sometimes available to bring 
the computer back from limbo. They are never entirely satisfactory, and 
should be thought of as a last resort. 

The technique differs from computer to computer. 
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PET/CBM 

Original ROM PETs cannot be uncrashed. 

Subsequent models can be uncrashed, though hardware additions are 
necessary. The reader should find someone with computer hardware 
knowledge to assist in fitting the switches to the computer 

A toggle switch is needed, to be connected to the "diagnostic sense" line 
of the parallel user port; that's pin 5 of the PUP. The other side of the 
toggle switch should connect to ground (pin IE). 

Additionally, a momentary pushbutton is required. This must connect the 
reset line of the computer to ground Technically speaking, it's better to 
trigger the input of the computer's power-on reset chip (a 555 one-shot), 
using a resistor to guard against accidentally grounding a live circuit. 

To uncrash, set the toggle switch to ''on" and press the pushbutton; the 
machine will come back to life in the machine language monitor Set the 
toggle switch off. There's more work tQ do. 

The computer is still in an unstable state. To correct this, either of two 
actions may be taken. You may return to BASIC with . X and immediately 
give the command CLR; Alternatively, you may type . ; followed by the 
RETURN key. 

Whatever investigation or other action is needed should be performed 
quickly and the computer reset to its normal state. 



VICI Commodore 64 

You might try holding down the RUN/STOP key and tapping the 
RESTORE key TO see if that will bnng the machine to its senses. Oth- 
erwise, you must do a more senous reset. 

You must depend on the fact that the computer does a nondestructive 
memory test dunng reset There are various commercially available in- 
terfaces for the cartridge port— usually "mother boards" that are fitted with 
reset switches 

When the reset switch is pressed, the computer starts from the beginning; 
but memory is not disturbed. If you have logged the entry location of the 
machine language monitor, you can bring it back with the appropriate SYS 
command. 
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Commodore PLUS/4 

There's a reset button next to the power switch. Before you press it, hold 
down the RUN/STOP and CTRL keys. Now press the reset button and 
you'll find yourself in the machine language monitor. 




Supermon 
Instructions 

Program Supermon is not a monitor; it is a monitor generator that will 
make a machine language monitor for you. There's a reason for this. 
Supermon finds a likely spot in memory and then plunks the MLM there 
so as to fit it into the most suitable place. 

Load Supermon and say RUN. It will write an MLM for you, and call it up 
Now, exit back to BASIC and command NEW. You do not want the MLM 
builder any more (it's done the job) and you do not want the danger of 
building two — or more — MLM's. Get rid of the generator program. Any 
time you need to use the MLM, give SYS< or SYSfl, as appropriate 

Supermon contains the following "essential" commands: 

. R— to display (and change) registers 
. M — to display (and change) memory 
. S— to save memory to disk or tape 
. L— to load from disk or tape 
. G — to go to an IVIL program 
. X— to exit to BASIC 

Supermon also contains the following extra commands: 

. A— to assemble 
. D — to disassemble 
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Most versions of Supermon (not the "do-it-yourself" below) contain the 
following commands. Though not used by this book, they are useful: 

. F — fills memory with fixed contents: 

.F IflDD IflFF □□ 
. H — hunts for a memory pattern: 

.H DflDD IflDD 2D DE FF 
. T — transfers a block of memory to a new location: 

.T DflDD DBFF flDDD 

A few versions of Supermon contain the command .1 which causes ma- 
chine language single stepping. 



A Do- It- Yourself Supermon 

If you do not have access to Supermon from friends, dealers, clubs, or 
disk, you may find the following program useful for the Commodore 64 
only. 

Enter this program (it will take you hours) Be sure that lines 3DD and 
above are correct; the lower numbered DATA lines will be checked for 
accuracy by the program. 

When you say RUN, the program will run in two phases. Part 1 takes over 
two minutes to run: it will check all DATA statements for missing lines 
and errors and report any problems to you. Part 2 will run only if part 1 
shows no errors: it will cause the program to "collapse" into itself, resulting 
in Supermon. The moment the program has completed running, save 
Supermon to disk or tape. 

The Supermon generated by this program is a "junior" version (to save 
your fingers) but it contains all commands needed for this book. 

1 DATA fl, 153, 3<,l<7,lfl,2q,2q, - 3D 

2 DATA Eq, 53, fl5,5D,tq, 52, 32,5^,52, - It 

3 DATA ^5,77,7q,7fl,D,^q,5,llD,D,153, -3q 
A DATA 3^,17,32,32,32,3E,32,32,3E,32,-5D 
5 DATA 3E,3E,3E,3E,3E,3E,3E,D,75,5,-3 

t DATA lED,D,153,3^,17,3E,^t ,<t,7^ ,7 3, -^5 
7 DATA 77,3E,tt,fl5,fl^,fl<,tH,flE,7D,73,-5t 
5 DATA tH,7t,t5,D,lDE,fl,13D,D,15fl,^D,-^ 
q DATA iq<,^D,5E,51,^l,17D,5D,53,5<,17E, -53 
ID DATA ,^D,5E,5E,<l,17D,<q,5D,55,<l, -55 

11 DATA □,D,D,17D,17D,17D,17D,17D,17D,17D, -t^ 

12 DATA 17D,17D,17D,17D,17D,17D,17D,17D,17D,17D, -Eq 
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13 DflTfl 17D,17D,17D,17D,17D,17D,17D,lt5,45,133, -tl 

lA DflTfl 34, lt.5, 4 1, 133, 35, It 5, 55, 133, 3 1, Its, -12 

15 DflTfl 5b, 133, 37, lbD,D, It 5, 34, 2D a, 2, 1^5, -55 

lb DflTfl 35,iqfl,34,177,34,2Da,bD,lt5,34,2Dfl, -34 

17 DflTfl a, ina, 35, ina, 34, 177, 34, 24 0,33, 133, -52 

Ifl DflTfl 3fl,lb5,34,2Dfl,2,iqfl,35,iqfl,34,177, -tD 

iq DflTfl 34, 24,101, 3b, 17D,lt5, 35, 101,37, 72, -5t 

2D DflTfl lb5,55,2Dfl,2,iqfl,5t,iq5,55,lD4,14 5, -1 

21 DflTfl 55,13fl,72,lb5,55,2D5,2,iqfl,5t,iqfl, -1 

22 DflTfl 55,lD4,145,55,24,144,lfl2,2Dl,7q,2D5, -45 

23 DflTfl 237, lb5, 55, 133, 51, It 5, 5 1, 133, 5 2, IDA, -17 

24 DflTfl 55, □,7q,7q,7q, 7^,173,23 0,255, 0,-22 

25 DflTfl 141,22,3,173,231,255,0,141,23,3, -t4 

2b DflTfl Ibq, 125, 32, 144, 255, □,D,21t, 104,141, -3D 

27 DflTfl b2,2,lD4,141,bl,2,lD4,141,tD,2, -41 

25 DflTfl lD4,141,5q,2,lD4,17D,lD4,lt5,5t,13fl, -17 

2q DflTfl 233, 2, 14 1,55, 2, 152, 233, 0,0,141, -12 

3D DflTfl 57, 2, 1 at, 142, b3, 2, 3 2, 147, 253,0, -57 

31 DflTfl lb2, bb,lbq, 42, 32,205, 251, 0,ltq, 52, -t2 

32 DflTfl 2G5,4 2,23G,iq3,2Ga,t,230,iq4,2 0a,2, -52 

33 DflTfl 23G, 35, qt, 32, 207,255, 201, 13, 20 a, 24 a, -24 

34 DflTfl lD4,lD4,lbq,D,D,133,3fl,lt2,13,ltq, -11 

35 DflTfl 4 b, 32, 2G5, 251, G, 32, 220, 24 q, 0,201, -32 

3b DflTfl 4b,24G,24q,2Dl,32,24 0,24 5,lt2,14,221, -23 

37 DflTfl iq5,255,D,2Dfl,12,13a,10,17 0,iaq,207, -3t 

36 DflTfl 255,G,72,lflq,2Gb,2 55,0,7 2,qt,202, -2 
3q DflTfl lb,23b,7b,5G,252,0,lt5,iq3,141,5a, -2q 
4D DflTfl 2,lb5,iq4,141,57,2,qt,ltq,5,133, -44 
41 DflTfl 2q,lbD,D,D,32,143,253,0,17 7,iq3, -31 

4 2 DflTfl 32,iqG,251,G,32,20q,24q,0,iqa,2q, -tl 

43 DflTfl 2D5,241,qb,32,254,251,0,144,ll,lt2, -53 

44 DflTfl D,G,12q,iq3,iq3,iq3,24 0,3,7t,a0, -55 

45 DflTfl 252,D,32,2Gq,24q,0,iq5,2q,qt,ltq, -5t 

4b DflTfl 5q,i33,iq3,ibq,2,i33,iq4,ibq,5,qb, -20 

47 DflTfl 152,72,32,147,253,0,104,lb2,4t,7t, -44 

46 DflTfl 2G5, 251, G,lb2,G,G,15q, 234, 255,0, -31 

4q DflTfl 32, 210, 255, 232, 224, 22, 205, 24 5, lt0,5q, -51 

50 DflTfl 32, 5b, 250, 0, 173, 57, 2, 3 2, iq 0,251, -4 

51 DflTfl 0, 173, 55, 2, 32, iqO, 251, 0,3 2, 75, -31 

52 DflTfl 250,0,32,33,250,0,24 0, 57,32,22 0, -13 

53 DflTfl 24q,0,32,23q,251,0,144,4t,32,2 23, -40 

54 DflTfl 251, 0, 32, 220, 24q, 0,3 2, 23 q, 251,0, -51 

55 DflTfl 144,35,32,^23,251,0,3 2,225,255,24 0, -33 



240 MACHINE LANGUAGE FOR COMMODORE MACHINES 



5t DATA tD,ltt,3fl,2Dfl,5t,lt5,in5,iq7,iq3,lt5,-22 

57 DATA iqt,22q,iq^,1^4,4t,ltD,5fl,32,flt,25D, -21 

5fl DATA 32, 163, 251, □,32, 31, 250, 240, -hO 

5q DATA 22/i,7t,flD,252,D,32,23q,251,D,l/i4, -/i2 

to DATA 3,32,2D,25D,D,32,7 5,25D,D,2Dfl, -/i3 

bl DATA 7, 32, 23^,251, 0,14/;, 235, Itq, a, 133, -26 

t2 DATA 2q,3 2,22D,24q,D,32,53,25D,D,2Dfl, -Ifl 

t3 DATA 24fl,7t,22q,24q,D,32,2D7,255,2Dl,13, -22 

t4 DATA 240, 12, 2D1, 32, 2Dfl,2Dq, 32,23^,251,0, -57 

t5 DATA 144, 3, 32, 2D, 250, □, 174, t3, 2, 154, -4t 

LL DATA 120,173, 57, 2, 7 2,173,53,2,7 2, 173, -35 

t7 DATA 5q, 2, 72, 173, to, 2, 174, tl, 2, 172, -55 

tfl DATA t.2,2,t.4,174,t.3,2,154,lDfl,2,lt.D, - St. 

DATA ItD, 1, 132, Iflt, 132, IBS, 13 1, 132, 153,132, -27 

70 DATA 144, 132, 147, lbq,t.4 ,133,157, Itn, 2,133, -iq 

71 DATA Iflfl, 32, 207,255,201, 32, 24D,24q, 201,13, -4 2 

72 DATA 24 0, St., 201, 34,205,20,32, 207, 255, 201, -35 
7 3 DATA 34, 240, It., 201, 13, 24 0,4 1,14 5, lfl7, 230, -3q 

74 DATA Ifl3,200,iq2,lt.,20fl,23t.,7t.,fl0,252,0, -Ifl 

75 DATA 32,207,255,201,13,24 0,22,201,44,205,-51 
7t. DATA 220,32,254,251,0,41,15,240,233,201, -4 1> 
77 DATA 3, 24 0,22^,133, Ifl t., 32, 207, 255, 201, 13, -45 
7fl DATA qt.,10fl,4fl,3,10fl,50,3,32,22,251, -t.0 

7q DATA D,20fl,212,lt.q,0,0,32,lll,251,0, -37 

flO DATA lt.5,144,41,lt.,20fl,201,7t.,22q,24q,0, -22 

fll DATA 32,22,251,0,201,44,20fl,iqi,32,23q, -4fl 

fl2 DATA 251,0,32,223,251,0,32,207,255,201, -25 

fl3 DATA 44,20fl,17fl,32,23q,251,0,lt.5,iq3,133, -7 

fl4 DATA 174, Its, 1^4,133, 175, 32, 223, 251, 0,32, -34 

as DATA 207, 255, 201, 13, 206, 157, 32, 114, 251,0, -3b 

at DATA 7b,22q,24q,0,lt5,iq4,32,iq0,251,D, -3q 

a7 DATA Its, 1^3,7 2,74, 74, 74, 74, 32, 214, 251, -13 

aa DATA 0,170,104,41,15,32,214,251,0,72, - It 

aq DATA 13 a, 3 2, 210, 255, 104, 7b, 210, 255, q, 4 a, -q 

qO DATA 201,5a,144,2,105,t,qt,lt2,2,lfll, - 3D 

qi DATA Iq2,7 2,iai,iq4,i4q,iq2,i04,i4q,iq4,202, -25 

q2 DATA 20a, 243, qt, 32, 254, 251, 0,144, 2, 133, -30 

q3 DATA iq4,32,254,251,0,144,2,133,iq3,qt, -43 

q4 DATA Itq, 0,0, 133, 42, 32, 220, 24 q, 0,201, -3q 

qS DATA 32, 20a, q, 32, 220, 24q, 0,201,32,206, -25 

qt DATA 14, 24, qt, 32, 37, 252, 0,10, 10, 10, -t2 

q7 DATA 10, 133, 4 2, 32, 220, 24q, 0,32, 37 ,252, -3q 

qa DATA 0, 5, 4 2, 5 t,qt, 201,5a, 144, 2, 105, -2t 
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qR DATA fl,41,15,Rt,Rt,3E,EED,E4R,D,EDl,-tE 

!□□ DATA 3E,E4D,E4R,Rt, ltR,D,D, 141, D,D, -EE 

IDl DATA 1,3E,47,E5E,D,3E,5,E5E,D,3E,-ER 

IDE DATA E4a,E51,D,144,R,Rt,3E,EED,E4R,D,-Efl 

1D3 DATA 3 E, E3R,E51,D, 17 t,EEE, 174, t3,E, 154, -35 

1D4 DATA ltR,t3,3E,ElD,E55,7t,EER,E4R,D,3E,-4fl 

ID 5 DATA 14 3,E53,D,EDE,EDfl,E5D,Rt,lt5,lR5,lt4,-15 

IDt DATA lRt,5t,E33,E,17t,l,13t,5t,EER,lR3,-tl 

1D7 DATA 133,3D,15E,EER,lR4,ltfl,5,3D,Rt,3E,-41 

IDA DATA 55, E5E, D, 133, 3E,lt5,lR4, 133, 33, ItE, - EE 

IDq DATA D,D,134,4D,ltR,14 7,3E,ElD,E55,ltR,-3E 

IID DATA EE, 133, ER,3E,lt5,E5E,D,3E, 5, E53,-E 

111 DATA D,133,lR3,13E,lR4,lRfl,Eq,EDfl,E4E,ltq, - It 

HE DATA 14 5,3E,ElD,E55,7t,EER,E4R,D,ltD,44,-41 

113 DATA 3E,flt,E5D,D,3E,143,E53,D,3E,lfl3, -E3 

114 DATA E51,D,3E,14 3,E53,D,ltE,D,D,ltl,-E5 

115 DATA 1R3,3E,ED,E53,D,7E,3E,RD,E53,D,-E5 
lit DATA lD4,3E,llE,E53,D,ltE,t,EE4,3,EDfl,-43 
117 DATA lfl,lt4,31,E4D,14,lt5,4E,EDl,E3E,177,-lD 
llfl DATA lR3,17t,Efl,3E,E53,E5E,D,13t,EDfl,E4E, -15 
IIR DATA t,4E,144,14,lflR,54,E55,D,3E,lfl7,-3 

lED DATA E53,D,lflR,tD,E5 5,D,E4D,3,3E,lfl7,-E4 

lEl DATA E53,D,EDE,EDfl,E13,Rt,3E,fl,E53,D,-45 

lEE DATA 17D,E3E,EDfl,l,EDD,15E,3E,E53,E5E,D,-3q 

1E3 DATA 13fl,134,Efl,3E,lRD,E51,D,ltt,Efl,Rt,-47 

1E4 DATA lt5,31,5t,lt4,lR4,17D,lt,l,13t,lDl, -53 

IE 5 DATA lR3,144,l,EDD,Rt,ltfl,74,144,ll,74,-El 

lEt DATA 17t,E3,EDl,34,E4D,lR,41,7,R,lEfl, -t3 

1E7 DATA 74,17D,lflR,EER,E54,D,17t,4,74,74,-5E 

lEfl DATA 74,74,41,15,EDfl,4,ltD,lEfl,ltR,D,-ED 

lER DATA D,17D,lflR,41,E55,D,133,4E,41,3,-tE 

13 D DATA 133,31,15E,41,14 3,17D,15E,ltD,3,EE4,-3t 

131 DATA 13fl,E4D,ll,74,144,fl,74,74,R,3E,-t 

13E DATA 13t,EDfl,E5D,EDD,13t,EDfl,E4E,Rt,177,iq3, -ER 

13 3 DATA 3E,E53,E5E,D,ltE,l,3E,RE,E5E,D,-lt 

134 DATA lRt,31,EDD,144,E41,ltE,3,lRE,4,144, -Ifl 

13 5 DATA E4E,Rt,ltfl,lfl5,t7,E55,D,133,4D,lfl5,-13 

13 1 DATA 131,E55,D,133,41,ltR,D,D,ltD,5,-3 

137 DATA t,41,3fl,4D,4E,13t,EDfl,E4fl,lD5,t3,-E7 

13 a DATA 3E,ElD,E55,EDE,EDfl,E3t,ltR,3E,EDfl,ll,-lt 

13R DATA ltR,13,3t,lR,lt,5,3E,ElD,E55,ltR,-3D 

14 D DATA lD,7t,ElD,E55,3E,55,E5E,D,ltR,3,-El 

141 DATA 133,ER,3E,EED,E4R,D,3E,53,E5D,D,-4E 
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l^E DATA EDfl,E<fl,lt5,3E,133,iq3,lt5,33,133,lR^, - A3 

1A3 DATA 7t,134,E5E,D,lR7,^D,E^D,3,3E,ElD,-tD 

lAA DATA E55,Rt,3E,55,E5E,D,3E,EE3,E51,D,-57 

IAS DATA l^E,17,E,ltE,3,3E,<7,E5E,D,7E,-^3 

l^t DATA EDE,EDfl,E4R,ltE,3,lD<,5t,E3 3,t3,ltD,-37 

1A7 DATA 5,7^,llD,17,E,llD,lt,E,13t,EDfl,-lt 

1A& DATA E4t,EDE,EDfl,E37,ltE,E,3E,ED7,E55,EDl,-31 

l^R DATA 13,E4D,3D,ED1,3E,E<D,E^5,3E,EED,E54,-R 

15D DATA D,17t,15,3E,lfl,E5E,D,lt4,iq3,13E, 

151 DATA lR^,133,iq3,ltR,<fl,157,lt,E,E3E,157, -A7 

15 E DATA lt,E,E3E,EDfl,ElR,13<,<D,ltE,D,D,-lD 

153 DATA 134,3fl,E4D,4,E3D,3fl,E4D,117,ltE,D,-q 

15^ DATA □,13<,ER,lt5,3fl,3E,ED,E53,D,ltt,-<fl 

15 5 DATA ^E, 134, 41, 17 D,lflfl,t7,E55, 0,113^,131, - 47 

15 1 DATA E55,D,3E,lR7,E54,D,EDfl,EE7,ltE,t,-54 

157 DATA EE4,3,EDfl,E5,lt4,31,E4D,El,lt5,4E,-t3 

15fl DATA EDl,E3E,ltR,4fl,17t,33,3E,ED3,E54,D,-3R 

15R DATA EDfl,ED4,3E,ED5,E54,D,EDfl,iqq,13t,EDfl, -Efl 

ItD DATA E35,t,4E,144,ll,lflfl,tD,E5 5,D,lflq,-15 

Itl DATA 54,E55,D,3E,lR7,E54,D,EDfl,lfll,EDE,-l 

ItE DATA EDfl,EDR,E4D,lD,3E,lRt,E54,D,EDfl,171,-51 

lt3 DATA 3E,lRt,E54,D,EDfl,ltt,lt5,4D,lR7,ER,-15 

lt4 DATA EDfl, ltD,3E,EE3,E51, 0,1^4, 31, E4 

It5 DATA lt5, 41, EDI, 157, EDfl,Et,3E,RR,E5E, 0,-35 

Itt DATA 144,lD,15E,EDfl,4,lt5,3D,lt,lD,7t,-4D 

lt7 DATA flD,E5E,D,EDD,EDfl,E5D,lt5,3D,lt,E4t,-R 

Itfl DATA lt4,31,EDfl,3,lfl5,lR4,D,D,145,iq3, -tE 

ItR DATA 13t,EDfl,E4fl,lt5,3fl,145,iq3,3E,5,E53, -41 

17 □ DATA 0,133,iq3,13E,lR4,ltD,t5,3E,flt,E5D,-34 

171 DATA D,3E,143,E53,D,3E,lfl3,E51,D,3E, -5t 

17 E DATA 143,E53,D,7t,lRfl,E53,D,lLa,3E,Eu3,-ET 

17 3 DATA E54,D,EDfl,17,15E,E4D,14,134,Efl,ltt,-t3 

174 DATA ER,EEl,lt,E,fl,E3E,134,ER,ltt,Efl, - to 

17 5 DATA 4D,Rt,EDl,4fl,14 4,3,EDl,71,qt,5t,-3D 

17 t DATA Rt,t4,E,tR,3,EDfl,fl,t4,R,4fl,-14 

17 7 DATA 34,tR,51,EDfl,fl,t4,R,t4,E,tR, -5D 

17fl DATA 51,EDfl,fl,t4,R,t4,E,tR,17q,EDfl, -47 

17 R DATA a, t4, q, 0,0,34,^3, 51, EDfl, 14 0,-13 

IflD DATA tfl,D,D,17,34,tfl,51,EDfl,14D,tfl,-5 

Ifll DATA 154,lt,34,tfl,51,EDfl,fl,t4,R,lt, - ED 

IflE DATA 34,tfl,51,EDfl,fl,t4,q,qfl,iq,lED,-tE 

lfl3 DATA ItR, 33, lER, 13 0,-41 

lfl4 DATA flR, 77, 14 5, 14 1, 134, 7 4, 133, 157, 44, 4 1, -3q 
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IflS DATA 44,35,4D,3t,flR,D,D,flfl,3t,3t,-EE 

Iflt DATA □,D,Efl,13fl,Efl,35,R3,13R,E7,ltl,-lD 

Ifl? DATA 157,13fl,ER,35,157,13q,ER,ltl,D,D, -R 

Iflfl DATA 41,E5,174,lD5,ltfl,E5,35,3t,fl3,E7, -t^ 

IflR DATA 35,3t,fl3,E5,ltl,D,D,Et,Rl,Rl,-E4 

IRD DATA 1 tS, IDS, 3t,3t, 174, 174, Itfl, 173,41,0,-3 

IRl DATA □,lE4,D,D,El,15t,lDR,15t,lt5,lD5,-ED 

IRE DATA 41,fl3,13E,lR,5E,17,lt5,lD5,35,ltD,-Et 

1R3 DATA Elt,Rfl,RD,7E,3fl,Rfl,14fl,13t,fl4,tfl,-ED 

1R4 DATA EDD,fl4,lD4,tfl,E3E,14fl,D,D,lflD,a, -31 

1R5 DATA 13E,llt,lflD,4D,llD,llt,E44,ED4,74,114, -3E 

IRt DATA E4E,lt4,13fl,D,D,17D,ltE,ltE,llt,llt,-ll 

1R7 DATA llt,114,tfl,lD4,17fl,5D,17a,D,D,34, - 3D 

IRfl DATA □,D,Et,Et,3fl,3fl,114,114,13t,EDD,-E7 

IRR DATA iqt,EDE,3a,7E,ta,tfl,ltE,EDD,5fl,5R, -35 

EDD DATA flE,77,71,fla,7t,a3,ta,44,t5,ED4,-5R 

EDI DATA E5D,D,iqi,E5D,D,Rt,E5D,D,134,E5D, -E5 

EDE DATA □, EE4 , E5D , D , 14 , E51 , D , lit , E51 , D , -E3 

ED3 DATA 135 , E51 ,□, lED , E5E , D , ItD , E53 , D , 1R4 , -IR 

ED4 DATA E53 , D , EEfl , E4R , D , 157 , E4R , D , 13R , E4q , -t3 

ED5 DATA D,13,3E,3E,3E,aD,t7,3E,3E,a3,-3 

EDt DATA flE,3E,t5,t7,3E,aa,aE,3E,aR,aE,-lt 

ED7 DATA 3E,fl3,aD, -5R 

E55 DATA EDfl 

3DD M=fc3 

BID READ X:L = PEEK(M) :H = L = E55:IFH THEN L = X 

BED V = R()L:S= (T()t3 AND R)D AND V) 

33D IF V THEN T = L:IF NOT S THEN R = R + 1:S = R()L 

34D T= (T*3 + X) ANDtB 

35D IF S THEN PRINT "ERROR LINE" ; R :E= -1 

3tD R = L:IF NOT H GOTO 31D 

37D IF E THEN STOP 

3&Q PRINT"HERE WE GO" : X =- 1 : RESTORE : B = ED4 R : FOR A = l 
TO HHHH 

BHD IF X) = D THEN POKE B,X:B = B + 1 

4DD READ X:L = PEEK(M) :IF L(E55 THEN NEXT A 

41D POKE 45,lt:P0KE 4t,lt:CLR 



I 

lA Chip 
Information 

The following material has been adapted from manufacturer's specifica- 
tions. The information is not essential to machine language programming, 
but can be a great help for further study. Some of these specifications are 
not widely published and contain "hard to get" information. 

6520 PI A, peripheral interface adaptor 
6522 VIA, versatile Interface adaptor 

6525 TPA, tn port adaptor 

6526 CIA. complex interface adaptor 
6545 CRTC, CRT controller 

6560 VIC video interface chip 
6566 VIC-e video interface chip 
6581 SID sound interface chip 

[Essentially manufacturer's specs, less hardware details] 
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6520 Peripheral Interface Adaptor (PIA) 

The 6520 is an I/O device wliicli acts as an interface between the micro- 
processor and peripherals such as printers, displays, keyboards, etc. The 
prime function of the 6520 is to respond to stimulus from each of the two 
worlds it is serving. On the one side, the 6520 is interfacing with peripherals 
via two eight-bit bi-directional peripheral data ports. On the other side, the 
device interfaces with the microprocessor through an eight-bit data bus. 
In addition to the lines described above, the 6520 provides four interrupt 
input/peripheral control lines and the logic necessary for simple, effective 
control of peripheral interrupts. 



MICRO 

PROCESSORS -< 
650 X 



8 BIT \ 
DATA ) 
BUS / 



( control) 



6520 



( control ) 



8 BIT 
DATA 
PORT 



8 BIT 
DATA 
PORT 

( CONTROL ) 



PERIPHERAL 
DEVICES- 
SPRINTERS, 
DISPLAYS, 
ETC. 



Figure 1.1 



7776 functional configuration of the 6520 is programmed by the micro- 
processor during systems initialization. Each of the peripheral data lines 
is programmed to act as an input or output and each of the four control/ 
interrupt lines may be programmed for one of four possible control modes. 
This allows a high degree of flexibility in the overall operation of the in- 
terface. 

Data Input Register 

When the microprocessor writes data into the 6520, the data which ap- 
pears on the data bus is latched into the Data Input Register. It is then 
transferred into one of six internal registers of the 6520. This assures that 
the data on the peripheral output lines will not "glitch," i.e., the output lines 
will make smooth transitions from high to low or from low to high and the 
voltage will remain stable except when it is going to the opposite polarity. 
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Control Registers (CRA and CRB) 

Figure 1.2 illustrates the bit designation and functions in the Control Reg- 
isters. The Control Registers allow the microprocessor to control the op- 
eration of the interrupt lines (CAl, CAE, CBl, CBE), and peripheral 
control lines (CAE, CBE). A single bit in each register controls the ad- 
dressing of the Data Direction Registers (DDRA, DDRB) and the Output 
Registers, (OR A, ORB) discussed below. In addition, two bits (bit t and 
7) are provided in each control register to indicate the status of the i nterrup t 
input li nes (CAl, CAE, CBl, CBE). These interrupt status bits (IRQA, 
IRQB) are normally interrogated by the microprocessor during the inter- 
rupt service program to determine the source of an active int errupt . These 
are the interrupt lines which drive the interrupt input (IRQ, N MI) of the 
microprocessor. The other bits in CRA and CRB are described in the 
discussion of the interface to the peripheral device. 

The various bits in the control registers will be accessed many times during 
a program to allow the processor to enable or disable interrupts, change 
operating modes, etc. as required by the peripheral device being con- 
trolled. 

Data Direction Registers fDDRA, DDRB; 

The Data Direction Registers allow the processor to program each line in 
the 8-bit Peripheral I/O port to act as either an input or an output. Each 
bit in DDRA controls the corresponding lines in the Peripheral A port and 
each bit in DDRB controls the corresponding line in the Peripheral B port. 
Placing a in the Data Direction Register causes the corresponding 
Peripheral I/O line to act as an input. A " 1 " causes it to act as an output. 

The Data Direction Registers are normally programmed only during the 
system initialization routine which is performed in response to a Reset 
signal. However, the contents of these registers can be altered during 
system operation. This allows very convenient control of some peripheral 
devices such as keyboards. 

Peripheral Output Registers fOR A, ORBj 

The Peripheral Output Registers store the output data which appears on 
the Peripheral I/O port. Writing an into a bit in OR A causes the 
corresponding line on the Peripheral A port to go low (< □ . V) if that 
line is programmed to act as an output. A " 1 causes the corresponding 
output to go high. The lines of the Peripheral B port are controlled by ORB 
in the same manner. 
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Interrupt Status Control 

The four interrupt/peripheral control lines (CAl, CAE, CBl, CBE) are 
controlled by the Interrupt Status Control (A, B) This logic interprets the 
contents of the corresponding Control Register, detects active transitions 
on the interrupt inputs and performs those operations necessary to assure 
proper operation of these four peripheral interface lines. 



Reset (^ES) 

The active low Reset line resets the contents of all 6520 registers to a 
logic zero. This line can be used as a power-on reset or as a master reset 
during system operation. 



Interrupt Request Line f I R Q A, I R Q b; 

The active low Interrupt Request lines (IRQ A and IRQB) act to interrupt 
the microprocessor either directly or through external interrupt priority cir- 
cuitry. 

Each Interrupt Request line has two interrupt flag bits which can cause 
the Interrupt Request line to go low These flags are bits t and 7 in the 
two Control Registers. These flags act as the link between the peripheral 
interrupt signals and the microprocessor interrupt inputs. Each flag has a 
corresponding interrupt disable bit which allows the processor to enable 
or disable the interrupt from each of the four interrupt inputs (CAl, CAE, 
CBl, CBE). 

The four interrupt flags are set by active transitions of the signal on the 
interrupt input (CAl, CAE, CBl, CBE). Controlling this active transition 
is discussed in the next section. 



Control of IRQA 

Control Register A bit 7 is always set by an active transition of the CAl 
interrupt input signal. Interrupting from this flag can be disabled by setting 
bit □ in the Control Register A (CRA) to a logic □. Likewise, Control 
Register A bit t can be set by an active transition of the CAE interrupt 
input signal. Interrupting from this flag can be disabled by setting bit 3 in 
the Control Register to a logic □. 

Both bit t and bit 7 in CRA are reset by a "Read Peripheral Output 
Register A" operation. This is defined as an operation in which the pro- 
cessor reads the Penpheral A I/O port. 
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Control of IRQB 

Control of IRQB is perfo rmed in exactly the same manner as that de- 
scribed above for IRQ A. Bit 7 in CRB is set by an active transition on 
CBl; interrupting from this flag is controlled by CRB bit 0. Likewise, bit 
t in CRB is set by an active transition on CBE; interrupting from this flag 
is controlled by CRB bit 3. 

Also, both bit t and bit 7 are reset by a "Read Peripheral B Output 
Register" operaWon. 

Summary 

IRQA goes low when OR A -7 = 1 and CRA -0 = 1 or when CRA -L 
= 1 and CRA-3 = 1. 

IRQB goes low when CRB -7 - land CRB - 1 or when CRB -t 
= 1 and CRB -3 - 1. 

It should be stressed at this point that the flags act as the link between 
the peripheral interrupt signal and the processor interrupt inputs The in- 
terrupt disable bits allow the processor to control the interrupt function. 

Peripheral I/O Ports 

Each of the Peripheral I/O lines can be programmed to act as an input or 
an output. This is accomplished by setting a " 1 " in the corresponding 
bit in the Data Direction Register for those lines which are to act as outputs. 
A in a bit of the Data Direction Register causes the corresponding 
Peripheral I/O lines to act as an input. 

Interrupt Input/ Peripheral Control Lines (CAl, 
CAE, CBl, CBE 

The four interrupt input/peripheral control lines provide a number of special 
peripheral control functions. These lines greatly enhance the power of the 
two general purpose interface ports (PAD-PA7, PBD-PB7). 

Peripheral A Interrupt Input/ Peripheral Control 
Unes (CAX CAE) 

CAl is an interrupt input only. An active transition of the signal on this 
input will set bit 7 of the Control Register A to a logic 1. The active transition 
can be programmed by the microprocessor by setting a " □ " in bit 1 of 
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the CRA if the interrupt flag (bit 7 of CR A) is to be set on a negative 
transition of the CAl signal or a " 1 if it is to be set on a positive transition. 

Setting the interrupt flag will interrupt the processor through IRQ A if bit 
□ of CR A IS a 1 as described previously. 

CAE can act as a totally independent interrupt input or as a peripheral 
control output. As an input (CRA / bit 5 = □) it acts to set the interrupt 
flag, bit t of CRA, to a logic 1 on the active transition selected by bit ^ 
of CRA. 

These control register bits and interrupt inputs serve the same basic func- 
tion as that described above for CAl. The input signal sets the interrupt 
flag which serves as the link between the peripheral device and the pro- 
cessor interrupt structure. The interrupt disable bit allows the processor 
to exercise control over the system interrupts. 

In the Output mode (CRA, bits 1), CAE can operate independently 
to generate a simple pulse each time the microprocessor reads the data 
on the Peripheral A I/O port. This mode is selected by setting CRA, bit ^ 
to a and CRA, bit 3 to a This pulse output can be used to 
control the counters, shift registers, etc. which make sequential data avail- 
able on the Peripheral input lines. 

A second output mode allows CAE to be used in conjunction with CAl 
to "handshake" between the processor and the peripheral device. On the 
A side, this technique allows positive control of data transfers from the 
peripheral device into the microprocessor. The CAl input signals the 
processor that data is available by interrupting the processor. The pro- 
cessor reads the data and sets CAE low. This signals the peripheral device 
that it can make new data available. 

The final output mode can be selected by setting bit ^ of CRA to a 1. in 
this mode, CAE is a simple peripheral control output which can be set 
high or low by setting bit 3 of CRA to a 1 or a □ respectively. 

Peripheral B Interrupt Input/Peripheral Control 
Unes (CBX CBEj 

CBl operates as an interrupt input only in the same manner as CAl. Bit 
7 of CRB is set by the active transition selected by bit □ of CRB. Likewise, 
the CBE input mode operates exactly the same as the CAE input modes. 
The CBE output modes, CRB, bit 5 = 1, differ somewhat from those 
of CAE. The pulse output occurs when the processor writes data into the 
Peripheral B Output Register. Also, the "handshaking" operates on data 
transfers from the processor into the peripheral device. 



APPENDIX I 



251 





7 


6 


5 4 3 


2 


1 


PRA 


IRDA 1 




CA2 CONTROL 

A. 


DDRA 
ACCESS 


CA1 CONTROL 








f - ^ 


f - ^ 
















7 


6 


5 4 3 


2 


1 


CRB 


iRQBI 


IRQB2 


CB2 CONTROL 


DDRB 
ACCESS 


CB2 CONTROL 








, * X 


/ * ^ 



Figure 1.2 

6545-1 CRT Controller (CRTC) 

Concept 

The 6545-1 is a CRT Controller intended to provide capability for iriter- 
facing the 6500 microprocessor family to CRT or TV-type raster scan 
displays. 

Horizontal Total (RO) 

This 8-bit register contains the total of displayed and non-displayed char- 
acters, minus one, per horizontal line. The frequency of HSYNC is thus 
determined by this register. 

Horizontal Displayed (R1) 

This 8-bit register contains the number of displayed characters per hori- 
zontal line. 

Horizontal Sync Position (R2) 

This 8-bit register contains the position of the HSYNC on the horizontal 
line, in terms of the character location number on the line. The position 
of the HSYNC determines the left-to-right location of the displayed text on 
the video screen. In this way, the side margins are adjusted. 
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Horizontal and Vertical SYNC Widths (R3) 

This 8-bit register contains the widths of both HSYNC and VSYNC, as 
follows: 



7 


6 


5 


4 


3 


2 


1 






8 4 2 1 8 4 2 1 

' 1 ' ' 1 ' 

VSYNC |WlDTH* HSYNC| WIDTH 

(NUMBER OF SCAN LINES) (NUMBER OF CHARACTER 

CLOCK TIMES) 

*tF BITS 4-7 ARE ALL "0", THEN VSYNC WILL BE 16 SCAN LINES WIDE 

Control of these parameters allows the 6545-1 to be interfaced to a variety 
of CRT monitors, since the HSYNC and VSYNC timing signals may be 
accommodated without the use of external one-shot timing. 



Vertical Total (R4) 

The Vertical Total Register is a 7-bit register containing the total number 
of character rows in a frame, minus one. This register, along with R5, 
determines the overall frame rate, which should be close to the line fre- 
quency to ensure flicl<er-free appearance. If the frame time is adjusted to 
be longer than the period of the line frequency, then RES may be used 
to provide absolute synchronism. 



Vertical Total Adjust (R5) 

The Vertical Total Adjust Register is a 5-bit write only register containing 
the number of additional scan lines needed to complete an entire frame 
scan and is intended as a fine adjustment for the video frame time. 



Vertical Displayed (R6) 

This 7-bit register contains the number of displayed character rows in each 
frame. In this way, the vertical size of the displayed text is determined. 
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Vertical Sync Position (R7) 

This 7-bit register Is used to select the character row time at which the 
VSYNC pulse Is desired to occur and, thus, Is used to position the dis- 
played text in the vertical direction. 

Mode Control (R8) 

This register Is used to select the operating modes of the 6545-1 and is 
outlined as follows: 



7 


6 


5 


4 


3 


2 


1 






J 



INTERFACE MODE CONTROL 



BIT 


OPERATION 


1 





X 





NON INTERLACE 


X 


1 


INVALID (DO NOT USE) 



VIDEO DISPLAY RAM ADDRESSING 
"0" FOR STRAIGHT BINARY 
"1" FOR ROW/COLUMN 

MUST PROGRAM TO "0" 



' DISPLAY ENABLE SKEW 

"0" FOR NO DELAY 
"1" TO DELAY DISPLAY ENABLE 
ONE CHARACTER TIME 

' CURSOR SKEW 

"0" FOR NEW DELAY 
"1" TO DELAY CURSOR ONE 
CHARACTER TIME 

^NOT USED 

Figure 1.3 

Scan Line (R9) 

This 5-bit register contains the number of scan lines per character row, 
including spacing. 
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Cursor Start (R10) and Cursor End (R11) 

These 5-bit registers select the starting and ending scan lines for the 
cursor. In addition, bits 5 and 6 of R10 are used to select the cursor mode, 
as follows: 




CURSOR MODE 



No Blinking 
No Cursor 

Blink at 1/16 field rate 
Blink at 1/32 field rate 



Note that the ability to program both the start and end scan line for the 
cursor enables either block cursor or underline to be accommodated. 
Registers R14 and R15 are used to control the character position of the 
cursor over the entire 16K address field. 

Display Start Address High (R12) and Low 
(R13) 

These registers together comprise a 14-bit register whose contents is the 
memory address of the first character of the displayed scan (the character 
on the top left of the video display, as in Figure 1). Subsequent memory 
addresses are generated by the 6545-1 as a result of CCLK input pulses. 
Scrolling of the display is accomplished by changing R12 and R13 to the 
memory address associated with the first character of the desired line of 
text to be displayed first. Entire pages of text may be scrolled or changed 
as well via R12 and R13. 

Cursor Position IHigti (R14) arid Low (R15) 

These registers together compnse a 14-bit register whose contents is the 
memory address of the current cursor position. When the video display 
scan counter (MA lines) matches the contents of this register, and when 
the scan line counter (RA lines) falls within the bounds set by RIO and 
R1 1 . then the CURSOR output becomes active. Bit 5 of the Mode Control 
Register (R8) may be used to delay the CURSOR output by a full CCLK 
time to accommodate slow access memories. 

LPEN High (R16) and Low (R17) 

These registers together comprise a 14-bii register whose contents is the 
light pen strobe position, in terms of the video display address at which 
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the strobe occurred. When the LPEN input changes from low to high, then, 
on the next negative-going edge of CCLK, the contents of the internal 
scan counter is stored in registers R16 and R17. 

6560 (VIC) Video Interface Chip 

The 6560 Video Interface Chip (VIC) is designed for color video graphics 
applications such as low cost CRT terminals, biomedical monitors, control 
system displays and arcade or home video games. It provides all of the 
circuitry necessary for generating color programmable character graphics 
with high screen resolution. VIC also incorporates sound effects and A/D 
converters for use in a video game environment. 

Features 

• Fully expandable system with a 16K byte address space 

• System uses industry standard 8 bit wide ROMS and 4 bit wide RAMS 

• Mask programmable sync generation, NTSC-6560, PAL-6561 

• On-chip color generation (16 colors) 

• Up to 600 independently programmable and movable background locations 
on a standard TV 

• Screen centering capability 

• Screen grid size up to 192 Horizontal by 200 Vertical dots 

• Two selectable graphic character sizes 

• On-chip sound system including: 

a) Three independent, programmable tone generators 

b) White noise generator 

c) Amplitude modulator 

• Two on-chip 8 bit A/D converters 

• ON-chip DMA and address generation 

• No CPU wait states or screen hash during screen refresh 

• Interlaced/Non-interlaced switch 

• 16 addressable control registers 

• Light gun/pen for target games 

• 2 modes of color operation 

A: Interlace mode: A normal video frame is sent to the TV 60 times each 
second. Interlace mode cuts the number of repetitions in half. When used 
with multiplexing equipment, this allows the VIC picture to be blended with 
a picture from another source. 
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To turn off: POKE 36864, PEEK(36864) AND 127 
To turn on: POKE 36864, PEEK(36864) OR 128 

B: Screen origin — horizontai: This determines the positioning of the 
image on the TV screen. The normal value is 5. Lowering the value moves 
the screen to the left, and increasing it moves the image to the right. 

To change value: POKE 36864, PEEK(36864) AND 128 OR X 



LOC 
Hex 


START VALUE-5K VIC 


Bit 

Function 


Binary 


Decimal 


9000 


00000101 


5 


ABBBBBBB 


9001 


00011001 


25 


CCCCCCCC 


9002 


1 UUl U M U 




HDDDDDDD 


9003 


voiomo 


46 or 176 


GEEEEEEF 


9004 


wwww 


V 


GGGGGGGG 


9005 


11110000 


240 


HHHHIIII 


9006 


00000000 





JJJJJJJJ 


9007 


00000000 





KKKKKKKK 


9008 


11111111 


255 


LLLLLLLL 


9009 


11111111 


255 


MMMMMMMM 


900A 


00000000 





NRRRRRRR 


900B 


00000000 





OSSSSSSS 


900C 


00000000 





P 11 11 11 1 


900D 


00000000 





QUUUUUUU 


900E 


00000000 





WWWWVVVV 


900F 


00011011 


27 


XXXXYZZZ 



A: 


Interlace mode: = off, 


N: 


Bass sound switch 




1 =on 


0: 


Alto sound switch 


B: 


Screen origin — horizontal 


P: 


Soprano sound switch 


C: 


Screen ongin — vertical 


Q: 


Noise switch 


D: 


Number of video columns 


R: 


Bass Frequency 


E: 


Number of video rows 


s- 


Alto Frequency 


F: 


Character size: 


T: 


Soprano Frequency 




= 8x8, 1=8x16 


U: 


Noise Frequency 


G: 


Raster value 


V: 


Loudness of sounds 


H: 


Screen memory location 


W: 


Auxiliary color 


1: 


Character memory location 


X: 


Screen color 


J: 


Light pen — horizontal 


Y: 


Reverse mode 0=on, 


K: 


Light pen — vertical 




1=off 


L: 


Paddle 1 


Z: 


Border color 


M: 


Paddle 2 
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C: Screen origin — vertical: This determines the up-down placement of 
the screen image. The normal value is 25. Lowering this causes the screen 
to move up by 2 rows of dots for each number lowered, and raising it 
moves the screen down. 

To change value: POKE 36865, X 

D: Number of video columns: Normally, this is set to 22. Changing this 
will change the display accordingly. Numbers over 27 will give a 27 column 
screen. The cursor controls are based on a fixed number of 22 columns, 
and changing this number makes the cursor controls misbehave. 

To change: POKE 36866, PEEK(36866) AND 128 OR X. 

E: Number of video rows: The number of rows may range from to 23 
A larger number of rows causes garbage to appear on the bottom of the 
screen. 

To change: POKE 36867, PEEK(36867) AND 129 OR (X*2) 

F: Character size: This bit determined the size of the matrix used for 
each character. A here sets normal mode, in which characters are 8 by 
8 dots. A 1 sets 8 by 16 mode, where each character is now twice as tall. 
8 by 16 mode is normally used for high resolution graphics, where it is 
likely to have many unique characters on the screen. 

To set 8 by 8 mode. POKE 36867, PEEK(36867) AND 254 

To set 8 by 16 mode: POKE 36867, PEEK(36867) OR 1 

G: Raster value: This number is used to synchronize the light pen with 
the TV picture. 

H: Screen memory location: This determines where in memory the VIC 
keeps the image of the screen. The highest bit in location 36869 must be 
a 1. Bits 4-6 of location 36869 are bits 10-12 of the screen's address, 
and bit 7 of location 36866 is bit 9 of the address of the screen. To 
determine the location of the screen, use the formula: 

S = 4* (PEEK(36866) AND 128) + 64* (PEEK(36869) AND 112) 

Note that bit 7 of location 36866 also det( amines the location of color 
memory. If this bit is a 0, color memory starts at location 37888. If this bit 
IS a 1 , color memory begins at 38400. Here is a formula for this: 

C = 37888 + 4* (PEEK(36866) AND 128) 

I: Character memory location: This determines where information on 
the shapes of characters are stored. Normally this pointer is to the char- 
acter generator ROM, which contains both the upper case/graphics or the 
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upper/lower case set. However, a simple POKE command can change 
this pointer to a RAM location, allowing custom character sets and high 
resolution graphics. 

To change- POKE 36869, PEEK(36869) AND 240 OR X 
(See chart on next page.) 

J: Light pen horizontal: This contains the latched number of the dot 
under the light pen, from the left of the screen. 

K: Light pen verticai: The latched number of the dot under the pen, 
counted from the top of the screen. 



X 


Location 


Contents 


Value 


HEX 


Decimal 





8000 


32768 


Upper case normal characters 


1 


8400 


33792 


Upper case reversed characters 


2 


8800 


34816 


Lower case normal characters 


3 


8C00 


35840 


Lower case reversed characters 


4 


9000 


36864 


unavailable 


5 


9400 


37888 


unavailable 


6 


9800 


38912 


V!C chip-unavaiiable 


7 


9C00 


39936 


ROM-unavailable 


8 


0000 





unavailable 


9 






unavailable 


10 






unavailable 


11 






unavailable 


12 


1000 


4096 


RAM 


13 


1400 


5120 


RAM 


14 


1800 


6144 


RAM 


15 


1C00 


7168 


RAM 



L: Paddle X: This contains the digitized value of a variable resistance 
(game paddle). The number reads from to 255. 

Wl: Paddie Y: Same as Paddle X, for a second analog input. 

N: Bass switch: If this bit is a 0, no sound is played from Voice 1. A 1 
in this bit results in a tone determined by Frequency 1. 

To turn on: POKE 36874, PEEK(36874) OR 128 

To turn off: POKE 36874, PEEK(36874) AND 127 

O: Aito switch: See Bass switch. 
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P; Soprano switch: See Bass switch. 
Q: Noise switcli: See Bass switch. 

R: Bass Frequency: This is a value corresponding to the frequency of 
the tone being played. The larger the number, the higher the pitch of the 
tone. 

The actual frequency of the sound in cycles per second (hertz) is deter- 
mined by the following formula: 

Clock 

Frequency = ^^^^ 

X is the number from to 127 that is put into the frequency register. If X 
is 127, then use - 1 for X in the formula. The value of Clock comes from 
the following table: 



Register 


NTSC (US TV's) 


PAL (European) 


36874 


3995 


4329 


36875 


7990 


8659 


36876 


15980 


17320 


36877 


31960 


34640 



To set: POKE 36874, PEEK(36874) AND 128 OR X 

S: Alto Frequency: This is a value corresponding to the frequency of the 
tone being played. The larger the number, the higher the pitch of the tone. 

T: Soprano Frequency: This is a value corresponding to the frequency 
of the tone being played. The larger the number, the higher the pitch of 
the tone. 

To set: POKE 36876, PEEK(36876) AND 128 OR X 

U: Noise Frequency: This is a value corresponding to the frequency of 
the noise being played. The larger the number, the higher the pitch of the 
noise. 

To set: POKE 36877, PEEK(36877) AND 128 OR X 

V: Loudness of sounds: This is the volume control for all the sounds 
playing. is off and 15 is the loudest sound. 

To set: POKE 36878, PEEK(36878) AND 240 OR X 

W: Auxiliary color: This register holds the color number of the auxiliary 
color. The value can be from to 15. 
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To set: POKE 36878, PEEK(36878) AND 15 OR (16*X) 

X: Screen color: A number from to 15 sets the color of thie screen. 

To set: POKE 36879, PEEK(36879) AND 240 OR X 

Y: Reverse mode: A 1 in thiis bit indicates normal characters, and a 
here causes all characters to be displayed as if reversed. 

To turn on reverse mode: POKE 36879. PEEK(36879) AND 247 

To turn off reverse mode. POKE 36879, PEEK(36879) OR 8 

Z: Border color: A number from to 7 sets the color of the screen. 

To set: POKE 36879, PEEK(36879) AND 248 OR X 



6522 Versatile Interface Adapter (VIA) 

The 6522 Versatile Interface Adapter (VIA) provides two peripheral ports 
With input latching, two powerful interval timers, and a serial-to-parallel/ 
parallel-to-serial shift register. 



6522 Versatile Interface Adapter Description 



ADDRESS 


DESCRIPTION 


REGISTER 


9110 


Port B 


AAAAAAAA 


9111 


Port A (with handshaking) 


BBBBBBBB 


9112 


Data Direction B 


CCCCCCCC 


9113 


Data Direction A 


DDDDDDDD 


9114 


Timer #1, low byte 


EEEEEEEE 


9115 


Timer #1, high byte 


FFFFFFFF 


9116 


Timer #1, low byte to load 


GGGGGGGG 


9117 


Timer #1, high byte to load 


HHHHHHHH 


9118 


Timer #2, low byte 


llllllll 


9119 


Timer #2, high byte 


JJJJJJJJ 


911A 


Shift Register 


KKKKKKKK 


911B 


Auxiliary Control 


LLIVINNNOP 


911C 


Peripheral Control 


QQQRSSST 


911D 


Interrupt Flags 


UVWXYZab 


911E 


Interrupt Enable 


cedfghij 


911F 


Port A (no handshaking) 


kkkkkkkk 
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PORT A I/O REGISTER 

These- eight bits are connected to the eight pins which make up port B. 
Each pin can be set for either input or output. 

Input latching is available on this port. When latch mode is enabled the 
data in the register freezes when the CB1 interrupt flag is set. The register 
stays latched until the interrupt flag is cleared. 

Handshaking is available for output from this port. CB2 will act as a DATA 
READY SIGNAL. This must be controlled by the user program. CB1 acts 
as the DATA ACCEPTED signal, and must be controlled by the device 
connected to the port. When DATA ACCEPTED is sent to the 6522. the 
DATA READY line is cleared, and the interrupt flag is set. 

PORT B I/O REGISTER 

These eight bits are connected to the eight pins which make up port A. 
Each pin can be set for either input or output. Handshaking is available 
for both read and write operations. Write handshaking is similar to that on 
PORT B. Read handshaking is automatic. The CA1 input pin acts as a 
DATA READY signal. The CA2 pin (used for output) is used for a DATA 
ACCEPTED signal. When a DATA READY signal is received a flag is set. 
The chip can be set to generate an interrupt or the flag can be polled 
under program control The DATA ACCEPTED signal can either be a 
pulse or a DC level. It is set low by the CPU and cleared by the DATA 
READY signal. 

DATA DIRECTION FOR PORT B 

This register is used to control whether a particular bit in PORT B is used 
for input or output. Each bit of the data direction register (DDR) is asso- 
ciated with a bit of port B. If a bit in the DDR is set to 1 , the corresponding 
bit of the port will be an OUTPUT. If a bit in the DDR is 0, the corresponding 
bit of the port will be an INPUT. 

For example, if the DDR is set to 7, port B will be set up as follows: 



BITS NUMBER DDR PORT B FUNCTION 

1 OUTPUT 

1 1 OUTPUT 

2 1 OUTPUT 

3 INPUT 

4 INPUT 

5 INPUT 

6 INPUT 

7 INPUT 
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DATA DIRECTION REGISTER FOR PORT A 

This is similar to the DDR for port B, except that it works on PORT A. 

E,F,G,H: TIMER CONTROLS 

There are two timers on the 6522 chip. The timers can be set to count 
down automatically or count pulses received by the VIA. The mode of 
operation is selected by the Auxiliary Control register. 

TIMER T1 on the 6522 consists of two 8-bit latches and a 16-bit counter. 
The various modes of the TIMER are selected by setting the AUXILIARY 
CONTROL REGISTER (ACR). The latches are used to store a 16-bit data 
word to load into the counter. Loading a number into the latches does not 
affect the count in progress 

After it is set, the counter will begin decrementing at 1 MHz. When the 
counter reaches zero, an interrupt flag will be set, and the IRQ will go low. 
Depending on how the TIMER is set, either further interrupts will be dis- 
abled, or it will automatically load the two latches into the counter and 
continue counting. The TIMER can also be set to invert the output signal 
on a peripheral pin each time it reaches zero and resets. 

The TIMER locations work differently on reading and writing. 
WRITING TO THE TIMER: 

E: Write into the low order latch. This latch can be loaded into the low 
byte of the 16-bit counter. 

F: Write into the high order latch, write into the high order counter, trans- 
fer low order latch into the low order counter, and reset the TIMER T1 
interrupt flag. In other words, when this location is set the counter is loaded. 

G: Same as E. 

H: Write into the high order latch and reset the TIMER T1 interrupt flag. 
READ TIMER T1 

E: Read the TIMER T1 low order counter and reset the TIMER T1 in- 
terrupt flag. 

F: Read the TIMER T1 high order counter. 
G: Read the TIMER T1 low order latch. 
H: Read the TIMER T1 high order latch. 
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TIMER T2 

This TIMER operates as an interval timer (in one-shot mode), or as a 
counter for counting negative pulses on PORT B pin 6. A bit in the ACR 
selects which mode TIMER T2 is in. 



WRITING TO TIMER T2 

I: Write TIMER 12 low order byte of latch. 

J: Write TIMER T2 high order counter byte, transfer low order latch to 
low order counter, clear TIMER T2 interrupt flag. 

READING TIMER T2 

I: Read TIMER T2 low order counter byte, and clear TIMER T2 interrupt 
flag. 

K: SHIFT REGISTER 

A shift register is a register which will rotate itself through the CB2 pin. 
The shift register can be loaded with any 8-bit pattern which can be shifted 
out through the CBl pin, or input to the CB1 pin can be shifted into the 
shift register and then read This makes it highly useful for serial to parallel 
and parallel to serial conversions. 

The shift register is controlled by bits 2-4 of the Auxiliary Control register. 



L,M,N,0,P: AUXILIARY CONTROL REGISTER 

L: TIMER 1 CONTROL 

BIT # 7 6 

One-shot mode (output to PB7 disabled) 

1 Free running mode (output to PB7 disabled) 

1 One-Shot mode (output to PB7 enabled) 

1 1 Free running mode (output to PB7 enabled) 



M: TIMER 2 CONTROL 

TIMER 2 has 2 modes. If this bit is 0, TIMER 2 acts as an interval timer 
in one-shot mode. If this bit is 1, TIMER 2 will count a predetermined 
number of pulses on pin PB6. 
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N: SHIFT REGISTER CONTROL 



4 


3 


2 













onir 1 ritoio I tn uicsmdlcu 








1 


SHIFT IN (FROM CB1) UNDER CONTROL OF 








TIMER 2 





1 





SHIFT IN UNDER CONTROL OF SYSTEM CLOCK 








PULSES 





1 


1 


SHIFT IN UNDER CONTROL OF EXTERNAL 








CLOCK PULSES 


1 








FREE RUN MODE AT RATE SET BY TIMER 2 


1 





1 


SHIFT OUT UNDER CONTROL OF TIMER 2 


1 


1 





SHIFT OUT UNDER CONTROL OF SYSTEM 








CLOCK PULSES 


1 


1 


1 


SHIFT OUT UNDER CONTROL OF EXTERNAL 



CLOCK PULSES 



O: PORT B LATCH ENABLE 

As long as this bit is 0, the PORT B register will directly reflect the data 
on the pins. 

If this bit IS set to one. the data present on the input pins of PORT A will 
be latched within the chip when the CB1 INTERRUPT FLAG is set. As 
long as the CB1 INTERRUPT FLAG is set. the data on the pins can change 
without affecting the contents of the PORT B register. Note that the CPU 
always reads the register (the latches) rather than the pins 

Input latching can be used with any of the input or output modes available 
for CB2. 



P: PORT A LATCH ENABLE 

As long as this bit is 0. the PORT A register will directly reflect the data 
on the pins. 

If this bit is set to one, the data present on the input pins of PORT A will 
be latched within the chip when the CA1 INTERRUPT FLAG is set. As 
long as the CA1 INTERRUPT FLAG is set. the data on the pins can change 
without affecting the contents of the PORT A register. Note that the CPU 
always reads the register (the latches) rather than the pins. 

Input latching can be used with any of the input or output modes available 
for CA2. 
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Q,R,S,T THE PERIPHERAL CONTROL REGISTER 
Q: CB2 CONTROL 



Q 


Q 


Q 




7 


6 


5 


DESCRIPTION 











Interrupt Input Mode 








1 


independent Interrupt Input Mode 





1 





Input Mode 





1 


1 


Independent Input Mode 


1 








Handshake Output Mode 


1 





1 


Pulse Output Mode 


1 


1 





Manual Output Mode (CB2 is held LOW) 


1 


1 


1 


Manual Output Mode (CB2 is held HIGH) 



INTERRUPT INPUT MODE: 

The CB2 interrupt flag (IFR bit 3) will be set on a negative (high-to-low) 
transition on the CB2 input line. The CB2 interrupt bit will be cleared on 
a read or write to PORT B. 

INDEPENDENT INTERRUPT INPUT MODE: 

As above, the CB2 interrupt flag will be set on a negative transition on 
the CB2 input line. However, reading or writing to PORT B does not clear 
the flag. 

INPUT MODE: 

The CB2 interrupt flag (IFR bit 3) will be set on a positive (low-to-high) 
transition of the CB2 line. The CB2 flag will be cleared on a read or write 
of PORT B. 

INDEPENDENT INPUT MODE: 

As above, the CB2 interrupt flag will be set on a positive transition on the 
CB2 line. However, reading or writing PORT B does not affect the flag. 

HANDSHAKE OUTPUT MODE: 

The CB2 line will be set low on a write to PORT B. It will be reset high 
again when there is an active transition on the CB1 line. 

PULSE OUTPUT MODE: 

The CB2 line is set low for one cycle after a write to PORT B. 
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MANUAL OUTPUT MODE: 

The CB2 line is held low. 

MANUAL OUTPUT MODE: 

The CB2 line is held high. 

R: CB1 CONTROL 

This bit selects the active transition of the input signal applied to the CB1 
pin. If this bit is 0, the CB1 interrupt flag will be set on a negative transition 
(high-to-low). If this bit is a 1 , the CB 1 interrupt flag will be set on a positive 
(low-to-high) transition. 

S:CA2 CONTROL 



s 


s 


s 




3 


2 


1 


DESCRIPTION 











Interrupt Input Mode 








1 


Independent Interrupt Input Mode 





1 





Input Mode 





1 


1 


Independent Input Mode 


1 








Handshake Output Mode 


1 





1 


Pulse Output Mode 


1 


1 





Manual Output Mode (CA2 is held LOW) 


1 


1 


1 


Manual Output Mode (CA2 is held HIGH) 



INTERRUPT INPUT MODE: 

The CA2 interrupt flag (IFR bit 0) will be set on a negative (higli-to-low) 
transition on tlie CA2 input line. The CA2 interrupt bit will be cleared on 
a read or write to PORT A. 

INDEPENDENT INTERRUPT INPUT MODE: 

As above, the CA2 interrupt flag will be set on a negative transition on 
the CA2 input line. However, reading or writing to PORT A does not clear 
the flag. 

INPUT MODE: 

The CA2 interrupt flag (IFR bit 0) will be set on a positive (low-to-high) 
transition of the CA2 line. The CA2 flag will be cleared on a read or write 
of PORT A. 
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INDEPENDENT INPUT MODE: 

As above, the CA2 interrupt flag will be set on a positive transition on the 
CA2 line. However, reading or writing PORT A does not affect the flag. 

HANDSHAKE OUTPUT MODE: 

The CA2 line will be set low on a read or write to PORT A. It will be reset 
high again when there is an active transition on the CA1 line. 

PULSE OUTPUT MODE: 

The CA2 line is set low for one cycle after a read or write to PORT A. 

MANUAL OUTPUT MODE: 

The CA2 line is held low. 

MANUAL OUTPUT MODE: 

The CA2 line is held high. 

T: CA1 CONTROL 

This bit of the PGR selects the active transition of the input signal applied 
to the CA1 input pin. If this bit is 0, the CA1 interrupt flag (Bit) will be set 
by a negative transition (high-to-low) on the CA1 pin. If this bit is 1 , the 
CA1 interrupt flag will be set by a positive transition (low-to-high). 

There are two registers associated with interrupts: The INTERRUPT FLAG 
REGISTER (IFR) and the INTERRUPT ENABLE REGISTER (lER), The 
I PR has eight bits, each one connected to a register in the 6522. Each bit 
in the IFR has an associated bit in the lER. The flag is set when a register 
wants to interrupt. However, no interrupt will take place unless the cor- 
responding bit in the lER is set. 

UVWXYZab: INTERRUPT FLAG REGISTER 

When the flag is set, the pin associated with that flag is attempting to 
interrupt the 6502. Bit U is not a normal flag. It goes high if both the flag 
and the corresponding bit in the INTERRUPT ENABLE REGISTER are 
set. It can be cleared only by clearing all the flags in the IFR or disabling 
all active interrupts in the lER. 
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SET BY 

U IRQ STATUS 
V TIMER 1 time-out 



W TIMER 2 time-out 



X CB1 pin active transition 

Y CB2 pin active transition 

Z Completion of 8 shifts 

a CA1 pin active transition 

b CA2 pin active transition 



CLEARED BY 

Reading TIMER 1 low order 
counter and writing TIMER 1 
high order latch 
Reading TIMER 2 low order 
counter and writing TIMER 2 
high order counter 
Reading or writing PORT B 
Reading or writing PORT B 
Reading or writing the shift 
register 

Reading or wnting PORT A 
(BBBBBBBB in above chart) 
Reading or writing PORT A 
(BBBBBBBB in above chart) 



cdefghij: INTERRUPT ENABLE REGISTER 



c: ENABLE CONTROL 

if this bit is a during a write to this register, each 1 in bits 0-6 clears the 

corresponding bit in the lER. If this bit is a 1 during this register, each 1 

in bits 0-6 will set the corresponding lER bit. 

d TIMER 1 time-out enable 

e TIMER 2 time-out enable 

f CB1 interrupt enable 

g CB2 interrupt enable 

h Shift interrupt enable 

i CA1 interrupt enable 

j CA2 interrupt enable 



PORTA 

This is similar to BBBBBBBB, except that the handshaking lines (CA1 and 
CA2) are unaffected by operations on this port. 
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6526 (CIA) Complex Interface Adaptor 



REGISTER MAP 



RS3 




RS1 


RSO 


REG 


NAME 



















PRA 


PERIPHERAL DATA HE'.i A 











1 


1 


PRB 


PERIPHERAL DATA REG B 








1 





2 


DDRA 


DATA DIRECTION REG A 








1 


1 


3 


DDRB 


DATA DIRECTION REG B 





1 








4 


TA LO 


TIME4 A LOW REGISTER 





1 





1 


5 


TA HI 


TIMER A HIGH REGISTER 





1 


1 





6 


TB LO 


TIMER B LOW RE'JilSTER 





1 


1 


1 


7 


TB HI 


TIMER B HIGH REGISTER 













8 


TOD 10ths 


10lhs OF SECONDS REGISTER 










1 


9 


TOD SEC 


SECONDS REGISTER 







1 





A 


TOD MIN 


MINUTE'^^ REGISTER 







1 


1 


B 


TOD HR 


HOURS— AM/PM REGISTER 




1 








C 


SDR 


SERIAL DATA RE« = ISTER 




1 





1 


D 


ICR 


INTERRUPT CONTROL REGIS- 
TER 




1 


1 





E 


CRA 


CONTROL REG A 




1 


1 


1 


F 


CRB 


CONTROL REG B 



I/O Ports (PRA, PRB, DDRA, DDRB) 

Ports A and B each consist of an 8-bit Peripheral Data Register (PR) and 
an 8-bit Data Direction Register (DDR). If a bit in the DDR is set to a one, 
the corresponding bit in the PR is an output; if a DDR bit is set to a zero, 
the corresponding PR bit is defined as an input. On a READ, the PR 
reflects the information present on the actual port pins (PA0-PA7, PBO- 
PB7) for both input and output bits. Port A and Port B have passive pull- 
up devices as well as active pull-ups, providing both CMOS and TTL 
compatibility. Both ports have two TTL load drive capability. In addition to 
normal I/O operation, PB6 and PB7 also provide timer output functions. 

Handshaking 

Handshakin g on d ata transfers can be accomplished using the PC output 
pin and the FLAG input pin. PC will go low for one cycle following a read 
or write of PORT B. This signal can be used to indicate "data ready" at 
PORT B or "data accepted" from PORT B. Handshaking on 16-bit data 
transfers (using both PORT A and PORT B) is possible by always reading 
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or writing PORT A first. FLAG is a negative edge sensitive input \Nh\ch 
can be used for receiving tine PC output from anotl ier 652 6, or as a g eneral 
purpose interrupt input. Any negative transition of FLAG will set the FLAG 
interrupt bit. 



REG 


NAME 


D7 


De 


D5 


D4 


D3 


D2 


Di 


Do 





PRA 


PA7 


PAe 


PA5 


PA4 


PA3 


PA2 


PAi 


PAo 


1 


PRB 


PB7 


PBe 


PB5 


PB4 


PB3 


PB2 


PBi 


PBo 


2 


DDRA 


DPA7 


DPAe 


DPAs 


DPA4 


DPA3 


DPA2 


DPAi 


DPAo 


3 


DDRB 


DPB7 


DPBe 


DPBs 


DPB4 


DPB3 


DPB2 


DPBi 


DPBo 



Interval Timers (Timer A, Timer B) 

Each interval timer consists of a 16-bit read-only Timer Counter and a 16- 
bit write-only Timer Latch. Data written to the timer are latched in the Timer 
Latch, while data read from the timer are the present contents of the Time 
Counter. The timers can be used independently or linked for extended 
operations. The various timer modes allow generation of long time delays, 
variable width pulses, pulse trains and variat)ie frequency waveforms. 
Utilizing the CNT Input, the timers can count external pulses or measure 
frequency, pulse width and delay times of external signals. Each timer has 
an associated control register, providing independent control of the fol- 
lowing functions: 

Start/Stop 

A control bit allows the time to be started or stopped by the microprocessor 
at any time. 

PB On/Off: 

A control bit allows the timer output to appear on a PORT B output line 
(PB6 for TtlVIER A and PB7 for TIMER B) This function overrides the 
DDRB control bit and forces the appropriate PB line to an output. 

Toggle/Pulse 

A control bit selects the output applied to PORT B On every timer un- 
derflow the output can either toggle or generate a single positive pulse of 
one cycle duration. The Toqq'e output is set high whenever the timer is 
started and is set low by 'RES. 
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One-Shot/Continuous 

A control bit selects either timer mode. In one-shot mode, the timer will 
count down from the latched value to zero, generate an interrupt, reload 
the latched value, then stop. In continuous mode, the timer will count from 
the latched value to zero, generate an interrupt, reload the latched value 
and repeat the procedure continuously. 

Force Load 

A strobe bit allows the timer latch to be loaded into the timer counter at 
any time, whether the timer is running or not. 

Input Mode: 

Control bits allow selection of the clock used to decrement the timer. 
TIMER A can count 4)2 dock pulses or external pulses applied to the CNT 
pin. TIMER B can count 4)2 pulses, external CNT pulses, TIMER A un- 
derflow pulses or TIMER A underflow pulses while the CNT pin is held 
high. 

The timer latch is loaded into the timer on any timer underflow, on a force 
load or following a write to the high byte of the prescaler while the timer 
is stopped. If the timer is running, a write to the high byte will load the 
timer latch, but not reload the counter. 



READ (TIMER) 
REG NAME 



4 


TA LO 


TAL7 


TALe 


TAL5 


TAL4 


TAL3 


TAL2 


TALi 


TALo 


5 


TA HI 


TAH7 


TAHfi 


TAH5 


TAH4 


TAH3 


TAH2 


TAHi 


TAHo 


6 


IB LO 


TBL7 


TBU 


TBLs 


TBL4 


TBL3 


TBL2 


TBLi 


TBLo 


7 


IB HI 


TBH7 


TBHfi 


TBH5 


TBH. 


TBH3 


TBH2 


TBH, 


TBHo 



WRITE (PRESCALER) 
REG NAME 



4 


TA LO 


PAL7 


PALfi 


PALs 


PAL4 


PAL3 


PAL2 


PALi 


PALo 


5 


TA HI 


PAH7 


PAHe 


PAH5 


PAH4 


PAH3 


PAH2 


PAHi 


PAHo 


6 


TB LO 


PB7 


PBe 


PB5 


PB4 


PB3 


PB2 


PBi 


PBo 


7 


TBHI 


PBH7 


PBHfi 


PBHs 


PBH4 


PBH3 


PBH2 


PBHi 


PBHo 
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Time of Day Clock (TOO) 

The TOD clock is a special purpose timer for real-time applications TOD 
consists of a 24-hour (AM/PM) clock with 1/1 0th second resolution. It is 
organized into 4 registers: lOths of seconds, Seconds, Minutes and Hours. 
The AM/PM flag is in the MSB of the Hours register for easy bit testing. 
Each register reads out in BCD format to simplify conversion for driving 
displays, etc. The clock requires an external 60 Hz or 50 Hz (programm- 
able) TTL level input on the TOD pin for accurate timekeeping In addition 
to time-keeping, a programmable ALARM is provided for generating an 
interrupt at a desired time. The ALARM registers are located at the same 
addresses as the corresponding TOD registers. Access to the ALARM is 
governed by a Control Register bit. The ALARM is write-only; any read of 
a TOD address will read time regardless of the state of the ALARM access 
bit. 

A specific sequence of events must be followed for proper setting and 
reading of TOD. TOD is automatically stopped whenever a write to the 
Hours register occurs The clock will not start again until after a wnte to 
the lOths of seconds register. This assures TOD will always start at the 
desired time. Since a carry from one stage to the next can occur at any 
time with respect to a read operation, a latching function is included to 
keep all Time Of Day information constant dunng a read sequence. Ail 
four TOD registers latch on a read of Hours and remain latched until after 
a read of lOths of seconds. The TOD clock continues to count when the 
output registers are latched. If only one register is to be read, there is no 
carry problem and the register can be read "on the fly," provided that any 
read of Hours is followed by a read of lOths of seconds to disable the 
latching. 



READ 



REG NAME 



8 


TOD 
10THS 














Ta 


T4 


T2 


Ti 


9 


TOD 
SEC 





SH4 


SH2 


SHi 


SLs 


su 


SU 


SL, 


A 


TOD 
MIN 





MH4 


Mha 


MHi 


MLe 


ML4 


ML2 


MLi 


B 


TOD HR 


PM 








HH 


HLa 


HL4 


HL2 


HL. 
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WRITE 

CRB7 = TOD 

CRB7 - 1 ALARM 

(SAME FORMAT AS READ) 

Serial Port (SOR) 

The serial pon is a buffered, 8-bit synchronous shift register system. A 
control bit selects input or output mode. In input mode, data on the SP 
pin is shifted into the shift register on the rising edge of the signal applied 
to the CNT pin After 8 CNT pulses, the data in the shift register is dumped 
into the Serial Data Register and an interrupt is generated. In the output 
mode, TIMER A is used for the baud rate generator. Data is shifted out 
on the SP pin at 72 the underflow rate of TIMER A The maximum baud 
rate possible is 4)2 divided by 4, but the maximum useable baud rate will 
be determined by line loading and the speed at which the receiver responds 
to input data. Transmission win start following a write to the Serial Data 
Register (provided TIMER A is running and in continuous mode). The 
clock signal denved from TIMER A appears as an output on the CNT pin. 
The data in the Serial Data Register will be loaded into the shift register 
then shift out to the SP pin when a CNT pulse occurs. Data shifted out 
becomes valid on the falling edge of CNT and remains valid until the next 
falling edge. After 8 CNT pulses, an interrupt is generated to indicate more 
data can be sent. If the Serial Data Register was loaded with new infor- 
mation pnor to this interrupt, the new data will automatically be loaded 
into the Shift register and transmission will continue. If the microprocessor 
stays one byte ahead of the shift register, transmission will be continuous. 
If no further data is to be transmitted, after the 8th CNT pulse, CNT will 
return high and SP will remain at the level of the last data bit transmitted. 
SDR data is shifted out MSB first and serial input data should also appear 
in this format. 

The bidirectional capability of the Serial Port and CNT clock allows many 
6526 devices to be connected to a common serial communication bus on 
which one 6526 acts as a master, sourcing data and shift clock, while all 
other 6526 chips act as slaves. Both CNT and SP outputs are open dram 
to allow such a common bus. Protocol for master/slave selection can be 
transmitted over the senai bus, or via dedicated handshaking lines. 



REG NAME 



c 


SDR 


S7 


Se 


Ss 


S4 


S3 


S2 


s, 


So 
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Interrupt Control (ICR) 

There are five sources of interrupts on the 6526: underflow from TIMER 
A, und erflow from TIMER B, TOD ALARM, Senal Port full/empty and 
FLAG. A single register provides masking and interrupt information. The 
interrupt Control Register consists of a wnte-only MASK register and a 
read-only DATA register. Any interrupt will set the corresponding bit in the 
DATA register Any interrupt which is enabled by the MASK register will 
set the IR bit (MSB) of the DATA register and bring the IRQ pin low. In a 
multi-chip system, the IR bit can be polled to detect which chip has gen- 
erated an interrupt request The interrupt DATA register is cleared and 
the IRQ line returns high following a read of the DATA register. Since each 
interrupt sets an interrupt bit regardless of the MASK, and each interrupt 
bit can be selectively masked to prevent the generation of a processor 
interrupt, it is possible to intermix polled interrupts with true interrupts. 
However, polling the IR bit will cause the DATA register to clear, therefore, 
it IS up to the user to preserve the information contained in the DATA 
register if any polled interrupts were present. 

The MASK register provides convenient cont rol of ind ividual mask bits. 
When writing to the MASK register, if bit 7 (SET/CLEAR) of the data written 
is a ZERO, any mask bit written with a one will be cleared, while those 
mask bits written with a zero will be unaffected If bit 7 of the data written 
is a ONE, any mask bit written with a one will be set, while those mask 
bits written with a zero will be unaffected. In order for an interrupt flag to 
set IR and generate an Interrupt Request, the corresponding MASK bit 
must be set. 

READ (INT DATA) 



REG NAME 



D 


ICR 


IR 








FLG 


SP 


ALRM 


TB 


TA 


REG 


NAME 




WRITE (INT MASK) 










ICR 


S/C 


X 


X 


FLG 


SP 


ALRM 


TB 


TA 



Control Registers 

There are two control registers in the 6526, CRA and CRB. CRA is as- 
sociated with TIMER A and CRB is associated with TIMER B. The register 
format is as follows: 
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CRA: 

Bit Name Function 

START 1 = START TIMER A, = STOP TIMER A. This 

bit is automatically reset wlien underflow oc- 
curs during one-shot mode. 

1 PBON 1 - TIMER A output appears on PB6, - PB6 

norma! operation. 

2 OUTMODE 1 - TOGGLE, = PULSE 

3 RUNMODE 1 = ONE-SHOT, = CONTINUOUS 

4 LOAD 1 = FORCE LOAD (this is STROBE input, there 

is no data storage, bit 4 will always read back 
a zero and writing a zero has no effect). 

5 INMODE 1 - TIMER A counts positive CNT transitions, 

= TIMER A counts 4)2 pulses. 

6 SPMODE 1 - SERIAL PORT output (CNT sources shift 

dock), = SERIAL PORT input (external shift 
clock required). 

7 TODIN 1 =50 Hz clock required on TOD pin for ac- 

curate time, = 60 Hz clock required on TOD 
pin for accurate time. 

(Bits CRB0-CRB4 are identical to CRA0-CRA4 
for TIMER B with the exception that bit 1 con- 
trols the output of TIMER B on PB7). 
5,6 INMODE Bits CRB5 and CRB6 select one of four input 

modes for TIMER B as: 
CRB6 CRB5 

TIMER B counts 4)2 

pulses. 

1 TIMER B counts positive 

CNT transitions. 

1 TIMER B counts TIMER 

A underflow pulses. 
1 1 TIMER B counts TIMER 

A underflow pulses while 
CNT is high. 

7 ALARM 1 -writing to TOD registers sets ALARM, 

= writing to TOD registers sets TOD clock. 
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REG 


NAME 


TOD 
IN 


SP 

MODE 


IN 

MODE 


LOAD 


RUN 
MODE 


OUT 
MODE 


PB ON 


START 


E 


CRA 


- 60Hz 

1 = 50Hz 


- iNPUT 

1 OUT- 
PUT 


1 =CNT 


1 - FORCE 

LOAD 

(STROBE) 


= CONT 

1 -OS 


0- PULSE 
1 - TOGGLE 


O^PBeOFF 
1 - PBe ON 


= STOP 

1 -- START 



REG 


NAME 


ALARM 


IN 


MODE 


LOAD 


RUN 
MODE 


OUT 
MODE 


PB ON 


START 


F 


CRB 


O-TOD 
1 = 

ALARM 




1 
1 
1 


<i>2 

1 - CNT 

-TA 

1 -- CNT-TA 


1 -FORCE 
LOAD 

(STROBE) 


- CONT 

1 -OS 


- PULSE 

1 - TOGGLE 


0=PB7 OFF 
1 - PB7 ON 


- STOP 

1 = START 


1 TR 



All unused register bits are unaffected by a write and are forced to zero 
on a read. 



COMMODORE SEMICONDUCTOR GROUP reserves the right to 
make changes to any products herein to improve reliability, function 
or design. COMMODORE SEMICONDUCTOR GROUP does not 
assume any liability arising out of the application or use of any product 
or circuit descnbed herein; neither does it convey any license under 
Its patent rights nor the rights of others 



6566/6567 (VIC-II) Chip Specifications 

The 6566/6567 are multi-purpose color video controller devices for use in 
both computer video terminals and video game applications. Both devices 
contain 47 control registers which are accessed via a standard 8-bit mi- 
croprocessor bus (65XX) and will access up to 16K of memory for display 
information. The various operating modes and options within each mode 
are described. 

Character Display Mode 

In the character display mode, the 6566/6567 fetches CHARACTER 
POINTERS from the VIDEO MATRIX area of memory and translates the 
pointers to character dot location addresses m the 2048 byte CHARACTER 
BASE area of memory. The video matnx is compnsed of 1000 consecutive 
locations in memory which each contain an eight-bit character pointer. 
The location of the video matrix within memory is defined by VM13-VM10 
in register 24($i8) which are used as the 4 MSB of the video matnx 
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address. The lower order 1 bits are provided by an internal counter (VC3- 
VCO) which steps through the 1000 character locations. Note that the 
6566/6567 provides 14 address outputs; therefore, additional system hard- 
ware may be required for complete system memory decodes. 



CHARACTER POINTER ADDRESS 



A13 


A12 


A11 


A10 


A09 


AOS 


A07 


A06 


AOS 


A04 


AOS 


A02 


A01 


AOO 


VM13 


VM12 


VM11 


VM10 


VC9 


VC8 


VC7 


VC6 


VC5 


VC4 


VC3 


VC2 


VC1 


VCO 



The eight-bit character pointer permits up to 256 different character def- 
initions to be available simultaneously. Each character is an 8x8 dot 
matrix stored in the character base as eight consecutive bytes. The location 
of the character base is defined by CB13-CB11 also in register 24 ($18) 
which are used for the 3 most significant bits (MSB) of the character base 
address. The 1 1 lower order addresses are formed by the 8-bit character 
pointer from the video matrix (D7-D0) which selects a particular character, 
and a 3-bit raster counter (RC2-RC0) which selects one of the eight char- 
acter bytes. The resulting characters are formatted as 25 rows of 40 
characters each. In addition to the 8-bit character pointer, a 4-bit COLOR 
NYBBLE is associated with each video matrix location (the video matrix 
memory must be 12 bits wide) which defines one of sixteen colors for 
each character. 



CHARACTER DATA ADDRESS 



A13 


A12 


A11 


A10 


A09 


AOS 


A07 


A06 


AOS 


A04 


AOS 


A02 


A01 


AOO 


CB13 


CB12 


CB11 


D7 


D6 


D5 


D4 


D3 


D2 


D1 


DO 


RC2 


RC1 


RCO 



Standard Character Mode (MCM = BMM = 
ECM = 0) 

In the standard character mode, the 8 sequential bytes from the character 
base are displayed directly on the 8 lines in each character region. A "0" 
bit causes the background #0 color (from register 33 ($21 )) to be displayed 
while the color selected by the color nybble (foreground) is displayed for 
a "1" bit (see Color Code Table). 
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CHARACTER 




FUNCTION 


BIT 


COLOR DISPLAYED 


Background 





Background #0 color 






(register 33 ($21)) 


Foreground 


1 


Color selected dy 4-t)it color nybble 



Therefore, each character has a unique color determined by the 4-bit color 
nybble (1 of 16) and all characters share the common background color. 



Multi-Color Character Mode (MCM = 1, 
BMM = ECM = 0) 

Multi-color mode provides additional color flexibility allowing up to four 
colors within each character but with reduced resolution. The multi-color 
mode is selected by setting the MCM bit in register 22 ($16) to "1 ," which 
causes the dot data stored in the character base to be interpreted in a 
different manner. If the MSB of the color nybble is a "0," the character 
will be displayed as described in standard character mode, allowing the 
two modes to be inter-mixed (however, only the lower order 8 colors are 
available) When the MSB of the color nybble is a "1" (if MCM:MSB(CM) 
= 1) the character bits are interpreted in the multi-color mode: 



FUNCTION 


CHARACTER 
BIT PAIR 


COLOR DISPLAYED 


Background 


00 


Background #0 Color 






(register 33 ($21)) 


Background 


01 


Background #1 Color 






(register 34 ($22)) 


Foreground 


10 


Background #2 Color 






(register 35 ($23)) 


Foreground 


11 


Color specified by 3 LSB of color 






nybble 



Since two bits are required to specify one dot color, the character is now 
displayed as a 4 x 8 matrix with each dot twice the horizontal size as in 
standard mode. Note, however, that each character region can now con- 
tain 4 different colors, two as foreground and two as background (see 
MOB priority). 
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Extended Color Mode (ECM = 7, BMM = 
MCM = 0) 

The extended color mode allows the selection of individual background 
colors for each character region with the normal 8x8 character resolution. 
This mode is selected by setting the ECM bit of register 17 ($1 1) to "1." 
The character dot data is displayed as in the standard mode (foreground 
color determined by the color nybble is displayed for a "1" data bit), but 
the 2 MSB of the character pointer are used to select the background 
color for each character region as follows: 



CHAR. POINTER 
MS BIT PAIR 



00 
01 
10 

11 



BACKGROUND COLOR DISPLAYED FOR BIT 



Background #0 color (register 33 ($21)) 
Background #1 color (register 34 ($22)) 
Background #2 color (register 35 ($23)) 
Background #3 color (register 36 ($24)) 



Since the two MSB of the character pointers are used for color information, 
only 64 different character definitions are available. The 6566/6567 will 
force CB10 and CB9 to "0" regardless of the original pointer values, so 
that only the first 64 character definitions will be accessed. With extended 
color mode each character has one of sixteen individually defined fore- 
ground colors and one of the four available background colors. 



NOTE: Extended color mode and multi-color mode should not be enabled simulta- 
neously. 



Bit Map Mode 

In bit map mode, the 6566/6567 fetches data from memory in a different 
fashion, so that a one-to-one correspondence exists between each dis- 
played dot and a memory bit. The bit map mode provides a screen res- 
olution of 320H X 200V individually controlled display dots. Bit map mode 
is selected by setting the BMM bit in register 17 ($1 1) to a 1 . ' The VIDEO 
MATRIX is still accessed as in character mode, but the video matrix data 
is no longer interpreted as character pointers, but rather as color data. 
The VIDEO MATRIX COUNTER is then also used as an address to fetch 
the dot data for display from the 8000-byte DISPLAY BASE. The display 
base address is formed as follows: 
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A13 


A12 


All 


A10 


AOS 


AOS 


A07 


A06 


AOS 


A04 


AOS 


A02 


A01 


AOO 


CB13 


VC9 


VC8 


VC7 


VC6 


VC5 


VC4 


VC3 


VC2 


VC1 


VCO 


RC2 


RC1 


RCO 



VCx denotes the video matrix counter outputs, RCx denotes the 3-bit raster 
line counter and CB13 is from register 24 ($18). The video matnx counter 
steps through the same 40 locations for eight raster lines, continuing to 
the next 40 locations every eighth line, while the raster counter increments 
once for each horizontal video line (raster line). This addressing results 
in each eight sequential memory locations being formatted as an 8 x 8 
dot block on the video display. 

Standard Bit Map Mode (BMM = 1, 
MCM = 0) 

When standard bit map mode is in use, the color information is derived 
only from the data stored in the video matrix (the color nybble is disre- 
garded). The 8 bits are divided into two 4-bit nybbles which allow two 
colors to be independently selected in each 8 x 8 dot block. When a bit 
in the display memory is a "0" the color of the output dot is set by the 
least significant (lower) nybble (LSN) Similarly, a display memory bit of 
"1" selects the output color determined by the MSN (upper nybble). 



BIT 


DISPLAY COLOR 





Lower nybble of video matrix pointer 


1 


Upper nybble of video matrix pointer 



Multi-Color Bit Map Mode (BMM = MCM 
= 1) 

Multi-colored bit map mode is selected by setting the MCM bit in register 
22 ($16) to a "1" in conjunction with the BMM bit. Multi-color mode uses 
the same memory access sequences as standard bit map mode, but 
interprets the dot data as follows: 



BIT PAIR 


DISPLAY COLOR 


00 


Background #0 color (register 33 ($21)) 


01 


Upper nybble of video matrix pointer 


10 


Lower nybble of video matrix pointer 


11 


Video matrix color nybble 
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Note that the color nybble (DB1 1 -DBS) IS used for the multi-color bit map 
mode, again, as two bits are used to select one dot color, the horizontal 
dot size is doubled, resulting in a screen resolution of 160H x 200V. 
Utilizing multi-color bit map mode, three independently selected colors can 
be displayed m each 8x8 block in addition to the background color. 

Movable Object Blocks 

The movable object block (MOB) is a special type of character which can 
be displayed at any one position on the screen without the block constraints 
inherent in character and bit map mode. Up to 8 unique MOBs can be 
displayed simultaneously, each defined by 63 bytes in memory which are 
displayed as a 24x21 dot array (shown below). A number of special 
features make MOBs especially suited for video graphics and game ap- 
plications. 



MOB DISPLAY BLOCK 



BYTE 


BYTE 


BYTE 


00 


01 


02 


03 


04 


05 


57 


58 


59 


60 


61 


62 



Enable 

Each MOB can be selectively enabled for display by setting its corre- 
sponding enable bit (MnE) to "1" in register 21 ($15). If the MnE bit is 
"0," no MOB operations will occur involving the disabled MOB. 

Position 

Each MOB is positioned via its X and Y position register (see register 
map) with a resolution of 512 horizontal and 256 vertical positions. The 
position of a MOB is determined by the upper-left corner of the array. X 
locations 23 to 347 ($17-$157) and Y locations 50 to 249 ($32-$F9) are 
visible. Since not all available MOB positions are entirely visible on the 
screen, MOBs may be moved smoothly on and off the display screen. 
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Color 



Each MOB has a separate 4-bit register to determine the MOB color. The 
two MOB color modes are: 

STANDARD MOB (MnMC = 0) 

In the standard mode, a "0" bit of MOB data allows any background data 
to show through (transparent) and a "1 " bit is displayed as the MOB color 
determined by the corresponding MOB Color register. 

MULTI-COLOR MOB (MnMC = 1) 

Each MOB can be individually selected as a multi-color MOB via MnMC 
bits in the MOB Multi-color register 28 ($1C). When the MnMC bit is "1," 
the corresponding MOB is displayed in the multi-color mode. In the multi- 
color mode, the MOB data is interpreted in pairs (similar to the other multi- 
color modes) as follows: 



BIT PAIR 


COLOR DISPLAYED 


00 


Transparent 


01 


MOB Multi-color #0 (register 37 ($25)) 


10 


MOB Color (registers 39-46 ($27-$2E)) 


1 1 


MOB Multi-color #1 (register 38 ($26)) 



Since two bits of data are required for each color, the resolution of the 
MOB is reduced to 12x21, with each honzontal dot expanded to twice 
standard size so that the overall MOB size does not change. Note that up 
to 3 colors can be displayed in each MOB (in addition to transparent) but 
that two of the colors are shared among all the MOBs in the multi-color 
mode. 



Each MOB can be selectively expanded (2x) in both the horizontal and 
vertical directions. Two registers contain the control bits (MnXE,MnYE) 
for the magnification control: 



Magnification 



REGISTER 



FUNCTION 



23 ($17) 



Horizontal expand MnXE—"1" = expand; 
"0" = normal 

Vertical expand MnYE—"1" = expand; "0" = normal 



29 ($1D) 
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When MOBs are expanded, no increase in resolution is realized. The same 
24x21 array (12x21 if multi-colored) is displayed, but the overall MOB 
dimension is doubled in the desired direction (the smallest MOB dot may 
be up to 4 X standard dot dimension if a MOB is both multi-colored and 
expanded). 

Priority 

The priority of each MOB may be individually controlled with respect to 
the other displayed information from character or bit map modes. The 
prionty of each MOB is set by the corresponding bit (MnDP) of register 
27 ($1B) as follows. 



REG BIT 


PRIORITY TO CHARACTER OR BIT MAP DATA 





Non-transparent MOB data will be displayed (MOB in 




front) 


1 


Non-transparent MOB data wil be displayed only in- 




stead of Bkgd #0 or multi-color bit pair 01 (MOB be- 




hind) 



MOB— DISPLAY DATA PRIORITY 



MnDP = 1 


MnDP = 


MOBn 

Foreground 

Background 


Foreground 

MOBn 

Background 



MOB data bits of "0" ("00" in multi-color mode) are transparent, always 
permitting any other information to be displayed. 

The MOBs have a fixed priority with respect to each other, with MOB 
having the highest priority and MOB 7 the lowest. When MOB data (except 
transparent data) of two MOBs are coincident, the data from the lower 
number MOB will be displayed. MOB vs. MOB data is prioritized before 
prionty resolution with character or bit map data. 

Collision Detection 

Two types of MOB collision (coincidence) are detected, MOB to MOB 
collision and MOB to display data collision: 

1) A collision between two MOBs occurs when non-transparent output data of 
two MOBs are coincident. Coincidence of MOB transparent areas will not 
generate a collision. Wnen a collision occurs, the MOB bits (MnM) in the 
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MOB-MOB COLLISION register 30 ($1 E) will be set to "1 " for both colliding 
MOBs. As a collision between two (or more) MOBs occurs, the MOB-MOB 
collision bit for each collided MOB will be set. The collision bits remain set 
until a read of the collision register, when all bits are automatically cleared 
MOBs collisions are detected even if positioned off-screen. 
2) The second type of collision is a MOB-DATA collision between a MOB and 
foreground display data from the character or bit map modes. The MOB- 
DATA COLLISION register 31 ($1F) has a bit (MnD) for each MOB which 
IS set to "1" when both the MOB and non-background display data are 
coincident. Again, the coincidence of only transparent data does not generate 
a collision For special applications, the display data from the 0-1 multicolor 
bit pair also does not cause a collision. This feature permits their use as 
background display data without interfering with true MOB collisions. A MOB- 
DATA collision can occur off-screen in the horizontal direction if actual display 
data has been scrolled to an off-screen position (see scrolling). The MOB- 
DATA COLLISION register also automatically clears when read. 

The collision interrupt latches are set whenever the first bit of either register 
IS set to "1 ." Once any collision bit within a register is set high, subsequent 
collisions will not set the interrupt latch until that collision register has been 
cleared to all "Os" by a read. 



MOB Memory Access 

The data for each MOB is stored in 63 consecutive bytes of memory. Each 
block of MOB data is defined by a MOB pointer, located at the end of the 
VIDEO MATRIX. Only 1000 bytes of the video matrix are used in the 
normal display modes, allowing the video matrix locations 101 6-1 023 (VM 
base + $3F8 to VM base + $3FF) to be used for MOB pointers 0-7, re- 
spectively. The eight-bit MOB pointer from the video matrix together with 
the six bits from the MOB byte counter (to address 63 bytes) define the 
entire 14-bit address field: 



A13 


A12 


All 


A10 


A09 


AOS 


A07 


A06 


AOS 


A04 


A03 


A02 


A01 


AOO 


MP7 


MP6 


MPS 


MP4 


MP3 


MP2 


MP1 


MPO 


MCS 


MC4 


MCS 


MC2 


MCI 


MCO 



Where MPx are the MOB pointer bits from the video matrix and MCx are 
the internally generated MOB counter bits. The MOB pointers are read 
from the video matrix at the end of every raster line. When the Y position 
register of a MOB matches the current raster line count, the actual fetches 
of MOB data begin. Internal counters automatically step through the 63 
bytes of MOB data, displaying three bytes on each raster line. 
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Other Features 
Screen Blanking 

The display screen may be blanked by setting the DEN bit in register 17 
($1 1) to a "0." When the screen is blanked, the entire screen will be filled 
with the exterior color as in register 32 ($20). When blanking is active, 
only transparent (Phase 1) rriemory accesses are required, permitting full 
processor utilization of the system bus. MOB data, however, will be ac- 
cessed if the MOBs are not also disabled. The DEN bit must be set to "1 " 
for normal video display. 

Row/Column Select 

The normal display consists of 25 rows of 40 characters (or character 
regions) per row. For special display purposes, the display window may 
be reduced to 24 rows and 38 characters. There is no change in the format 
of the displayed information, except that characters (bits) adjacent to the 
exterior border area will now be covered by the border. The select bits 
operate as follows: 





NUMBER OF 




NUMBER OF 


RSEL 


ROWS 


CSEL 


COLUMNS 





24 rows 





38 columns 


1 


25 rows 


1 


40 columns 



The RSEL bit is in register 17 ($11) and the CSEL bit is in register 22 
($16). For standard display the larger display window is normally used, 
while the smaller display window is normally used in conjunction with 
scrolling. 



Scrolling 



The display data may be scrolled up to one entire character space in both 
the horizontal and vertical direction. When used in conjunction with the 
smaller display window (above), scrolling can be used to create a smooth 
panning motion of display data while updating the system memory only 
when a new character row (or column) is required. Scrolling is also used 
to center a fixed display within the display window. 



BITS 



X2,X1,X0 
Y2,Y1 ,Y0 



REGISTER 



22 ($16) 
17 ($11) 



FUNCTION 



Horizontal Position 
Vertical Position 
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Light Pen 



The light pen input latches the current screen position into a pair of reg- 
isters (LPX,LPY) on a low-going edge. The X position register 19 ($13) 
will contain the 8 MSB of the X position at the time of transition. Since the 
X position IS defined by a 5l2-state counter (9 bits) resolution to 2 hori- 
zontal dots is provided. Similarly, the Y position is latched to its register 
20 ($14) but here 8 bits provide single raster resolution within the visible 
display. The light pen latch may be tnggered only once per frame, and 
subsequent triggers within the same frame will have no effect Therefore, 
you must take several samples before turning the light pen to the screen 
(3 or more samples, average), depending upon the charactenstics of your 
light pen. 



The raster register is a dual-function register. A read of the raster register 
18 ($12) returns the lower 8 bits of the current raster position (the MSB- 
RC8 is located in register 1 7 ($1 1 )) The raster register can be interrogated 
to implement display changes outside the visible area to prevent display 
flicker. The visible display window is from raster 51 through raster 251 
($033-$0FB). A write to the raster bits (including RC8) is latched for use 
in an internal raster compare. When the current raster matches the wntien 
value, the raster interrupt latch is set. 



The interrupt register shows the status of the four sources of interrupt. An 
interrupt latch in register 25 ($19) is set to "1" when an interrupt source 
has generated an interrupt request. The four sources of interrupt are: 



Raster Register 



Interrupt Register 



LATCH 
BIT 



ENABLE 
BIT 



WHEN SET 



IRST 



ERST 



Set when (raster count) = (stored raster 
count) 

Set by MOB-DATA collision register (first 
collision only) 

Set by MOB-MOB collision register (first 
collision only) 

Set by negative transition of LP input (once 
per frame) 

Set high by latch set and enabled (invert of 
IRQ/ output) 



IMDC 



EMDC 



IMMC 



EMMC 



ILP 



ELP 



IRQ 
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To enable an interrupt request to set the IRQ/ output to "0," the corre- 
sponding interrupt enable bit in register 26 ($1 A) must be set to "1 " Once 
an interrupt latch has been set, the latch may be cleared only by writing 
a "1" to the desired latch in the interrupt register. This feature allows 
selective handling of video interrupts without software required to "re- 
member" active interrupts 

Dynamic Ram Refresh 

A dynamic ram refresh controller is built into the 6566/6567 devices. Five 
8-bit row addresses are refreshed every raster line. This rate guarantees 
a maximum delay of 2.02 ms between the refresh of any single row address 
in a 1 28 refresh scheme. (The maximum delay is 3.66 ms in a 256 address 
refresh scheme.) This refresh is totally transparent to the system, since 
the refresh occurs during Phase 1 of the system clock. The 6567 generates 
both RAS/ and CAS/ which are normally connected directly to the dynamic 
rams. RAS/ and CAS/ are generated for every Phase 2 and every video 
data access (including refresh) so that external clock generation is not 
required. 

Reset 

The reset bit (RES) in register 22 ($16) is not used for normal operation. 
Therefore it should be set to "0" when initializing the video chip. When 
set to a "1 the entire operation of the video chip is suspended, including 
video outputs and sync, memory refresh, and system bus access 

Theory of Operation 

System Interface 

The 6566/6567 video controller devices interact with the system data bus 
in a special way. A 65XX system requires the system buses only during 
the Phase 2 (clock high) portion of the cycle. The 6566/6567 devices take 
advantage of this feature by normally accessing system memory during 
the Phase 1 (clock low) portion of the clock cycle Therefore, operations 
such as character data fetches and memory refresh are totally transparent 
to the processor and do not reduce the processor throughput. The video 
chips provide the interface control signals required to maintain this bus 
sharing. 

The video devices provide the signal AEC (address enable control) which 
is used to disable the processor address bus drivers allowing the video 
device to access the address bus. AEC is active low which permits direct 
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connection to the AEC input of the 65XX family. The ABC signal is normally 
activated during Phase 1 so that processor operation is not affected. Be- 
cause of this bus "shanng," all memory accesses must be completed in 
y2 cycle. Since the video chips provide a 1-MHz clock (which must be 
used as system Phase 2), a memory cycle is 500 ns including address 
setup, data access and, data setup to the reading device. 

Certain operations of the 6566/6567 require data at a faster rate than 
available by reading only dunng the Phase 1 time; specifically, the access 
of character pointers from the video matrix and the fetch of MOB data. 
Therefore, the processor must be disabled and the data accessed during 
the Phase 2 clock. This is accomplished via the BA (bus available) signal. 
The BA line is normally high but is brought low during Phase 1 to indicate 
that the video chip will require a Phase 2 data access. Three Phase-2 
times are allowed after BA low for the processor to complete any current 
memory accesses. On the fourth Phase 2 after BA low, the AEC signal 
will remain low dunng Phase 2 as the video chip fetches data. The BA 
line IS normally connected to the RDY input of a 65XX processor. The 
character pointer fetches occur every eighth raster line during the display 
window and require 40 consecutive Phase 2 accesses to fetch the video 
matrix pointers. The MOB data fetches require 4 memory accesses as 
follows: 



PHASE 


DATA 


CONDITION 


1 


MOB Pointer 


Every raster 


2 


MOB Byte 1 


Each raster while MOB is displayed 


1 


MOB Byte 2 


Each raster while MOB is displayed 


2 


MOB Byte 3 


Each raster while MOB is displayed 



The MOB pointers are fetched every other Phase 1 at the end of each 
raster line. As required, the additional cycles are used for MOB data 
fetches. Again, all necessary bus control is provided by the 6566/6567 
devices. 

Memory Interface 

The two versions of the video interface chip, 6566 and 6567, differ in 
address output configurations. The 6566 has thirteen fully decoded ad- 
dresses for direct connection to the system address bus. The 6567 has 
multiplexed addresses for direct connection to 64K dynamic RAMs. The 
least significant address bits, A06-A00, are present on A06-A00 while RAS/ 
is brought low, while the most significant bits, A13-A08, are present on 
A05-A00 while CAS/ is brought low. The pins A11-A07 on the 6567 are 
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COLOR CODES 



D4 


D3 


D1 


DO 


HEX 


DEC 


COLOR 


n 

















BLACK 
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1 


1 


WHITE 








i 
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2 


RED 








1 


1 


3 


3 


CYAN 



u 


1 

1 








4 


4 


PURPLE 



u 


1 

1 
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5 


5 


GREEN 


n 


1 

1 







6 


6 


BLUE 





1 


1 

1 




7 


7 


YELLOW 












8 


8 


ORANGE 


1 








1 


9 


9 


BROWN 







1 





A 


10 


LT RED 







1 


1 


B 


11 


DARK GRAY 




1 








C 


12 


MED GRAY 




1 





1 


D 


13 


LT GREEN 




1 


1 





E 


14 


LT BLUE 




1 


1 


1 


F 


15 


LT GRAY 



static address outputs to allow direct connection of these bits to a con- 
ventional 16K (2K X 8) ROM. (The lower order addresses require external 
latching.) 



6581 Sound Interface Device (SID) Chip 
Specifications 

Concept 

The 6581 Sound Interface Device (SID) is a single-chip, 3-voice electronic 
music synthesizer/sound effects generator compatible with the 65XX and 
similar microprocessor families. SID provides wide-range, high-resolution 
control of pitch (frequency), tone color (harmonic content), and dynamics 
(volume). Specialized control circuitry minimizes software overhead, fa- 
cilitating use in arcade/home video games and low-cost musical instru- 
ments. 

Features 

• 3 TONE OSCILLATORS 
Range: 0-4 kHz 
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• 4 WAVEFORMS PER OSCILLATOR 

Triangle, Sawtooth, 
Variable Pulse, Noise 

• 3 AMPLITUDE MODULATORS 

Range: 48 dB 

• 3 ENVELOPE GENERATORS 

Exponential response 
Attack Rate 2 ms— 8 s 
Decay Rate* 6 ms— 24 s 
Sustain Level. 0— peak volume 
Release Rate 6 ms — 24 s 

• OSCILLATOR SYNCHRONIZATION 

• RING MODULATION 

Description 

The 6581 consists of three synthesizer "voices" which can be used in- 
dependently or in conjunction with each other (or external audio sources) 
to create complex sounds. Each voice consists of a Tone Oscillator/Wave- 
form Generator, an Envelope Generator and an Amplitude Modulator. The 
Tone Oscillator controls the pitch of the voice over a wide range. The 
Oscillator produces four wavefornns at the selected frequency, with the 
unique harmonic content of each waveform providing simple control of 
tone color. The volume dynamics of the oscillator are controlled by the 
Amplitude Modulator under the direction of the Envelope Generator. When 
triggered, the Envelope Generator creates an amplitude envelope with 
programmable rates of increasing and decreasing volume. In addition to 
the three voices, a programmable Filter is provided for generating complex, 
dynamic tone colors via subtractive synthesis. 

SIS allows the microprocessor to read the changing output of the third 
Oscillator and third Envelope Generator. These outputs can be used as 
a source of modulation information for creating vibrator, frequency/filter 
sweeps and similar effects. The third oscillator can also act as a random 
number generator for games. Two A/D converters are provided for inter- 
facing SID with potentiometers. These can be used for "paddles" in a 
game environment or as front panel controls in a music synthesizer. SID 
can process external audio signals, allowing multiple SID chips to be daisy- 
chained or mixed in complex polyphonic systems. 
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SID Control Registers 

There are 29 eight-bit registers in SID which control the generation of 
sound. These registers are either WRITE-only or READ-only and are listed 
below in Table 1, 

SID Register Description 

Voice 1 

FREQ LO/FREQ HI (Registers 00,01) 

Together these registers form a 16-bit number which linearly controls the 
frequency of Oscillator 1. The frequency is determined by the following 
equation: 

Fout = (Fn X Fe,k/1 677721 6) Hz 

Where Fn is the 16-bit number in the Frequency registers and F^k is the 
system clock applied to the ^2 input (pin 6). For a standard 1 .0-MHz clock, 
the frequency is given by: 

Fout = (Fn X 0.059604645) Hz 

A complete table of values for generating 8 octaves of the equally tempered 
musical scale with concert A (440 Hz) tuning is provided in Appendix E. 
It should be noted that the frequency resolution of SID is sufficient for any 
tuning scale and allows sweeping from note to note (portamento) with no 
discernable frequency steps. 

PW LO/PW HI (Registers 02,03) 

Together these registers form a 12-bit number (bits 4-7 of PW HI are not 
used) which linearly controls the Pulse Width (duty cycle) of the Pulse 
waveform on Oscillator 1. The pulse width is determined by the following 
equation: 

PWout = (PWn/40.95)% 

Where PW^ is the 12-bit number in the Pulse Width registers. 

The pulse width resolution allows the width to be smoothly swept with no 
discernable stepping. Note that the Pulse waveform on Oscillator 1 must 
be selected in order for the Pulse Width registers to have any audiDle 
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effect. A value of or 4095 ($FFF) in the Pulse Width registers will produce 
a constant DC output, while a value of 2048 ($800) will produce a square 
wave. 



CONTROL REGISTER (Register 04) 

This register contains eight control bits which select various options on 
Oscillator 1. 

Gate (Bit 0): The GATE bit controls the Envelope Generator for Voice 1. 
When this bit is set to a one, the Envelope Generator is Gated (triggered) 
and the ATTACK/DECAY/SUSTAIN cycle is initiated. When the bit is reset 
to a zero, the RELEASE cycle begins. The Envelope Generator controls 
the amplitude of Oscillator 1 appearing at the audio output, therefore, the 
GATE bit must be set (along with suitable envelope parameters) for the 
selected output of Oscillator 1 to be audible. A detailed discussion of the 
Envelope Generator can be found at the end of this Appendix. 

SYNC (Bit 1): The SYNC b\l when set to a one, synchronizes the fun- 
damental frequency of Oscillator 1 with the fundamental frequency of 
Oscillators, producing "Hard Sync" effects. 

Varying the frequency of Oscillator 1 with respect to Oscillator 3 produces 
a wide range of complex harmonic structures from Voice 1 at the frequency 
of Oscillator 3. In order for sync to occur. Oscillator 3 must be set to some 
frequency other than zero but preferably lower than the frequency of 
Oscillator 1. No other parameters of Voice 3 have any effect on sync. 

RiNG IWIOD (Bit 2): The RING MOD bit, when set to a one, replaces the 
Triangle waveform output of Oscillator 1 with a "Ring Modulated" com- 
bination of Oscillators 1 and 3. Varying the frequency of Oscillator 1 with 
respect to Oscillator 3 produces a wide range of non-harmonic overtone 
structures for creating bell or gong sounds and for special effects. In order 
for ring modulation to be audible, the Triangle waveform of Oscillator 1 
must be selected and Oscillator 3 must be set to some frequency other 
than zero. No other parameters of Voice 3 have any effect on ring mod- 
ulation. 

TEST (Bit 3): The TEST bit, when set to a one, resets and locks Oscillator 1 
at zero until the TEST bit is cleared. The Noise waveform output of Oscillator 1 
is also reset and the Pulse waveform output is held at a DC level. Normally 
this bit IS used for testing purposes, however, it can be used to synchronize 
Oscillator 1 to external events, allowing the generation of highly complex 
waveforms under real-time software control. 
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(Bit 4): When set to a one, the Tnangle waveform output of Oscillator 1 
is selected. The Tnangle waveform is low in harmonics and has a mellow, 
flute-like quality. 

(Bit 5): When set to a one, the Pulse waveform output of Oscillator 1 is 
selected. The Sawtooth waveform is rich in even and odd harmonics and 
has a bright, brassy quality. 

(Bit 6): When set to a one, the Pulse waveform of Oscillator 1 is selected. 
The harmonic content of this waveform can be adjusted by the Pulse 
Width registers, producing tone qualities ranging from a bright, hollow 
square wave to a nasal, reedy pulse. Sweeping the pulse width in real- 
time produces a dynamic "phasing" effect which adds a sense of motion 
to the sound. Rapidly jumping between different pulse widths can produce 
interesting harmonic sequences 

NOISE (Bit 7): When set to a one, the Noise output waveform of Oscillator 1 
is selected. This output is a random signal which changes at the frequency 
of Oscillator 1. The sound quality can be varied from a low rumbling to 
hissing white noise via the Oscillator 1 Frequency registers. Noise is useful 
in creating explosions, gunshots, jet engines, wind, surf and other un- 
pitched sounds, as well as snare drums and cymbals. Sweeping the os- 
cillator frequency with Noise selected produces a dramatic rushing effect. 

One of the output waveforms must be selected for Oscillator 1 to be au- 
dible, however, it is NOT necessary to de-select waveforms to silence the 
output of Voice 1 . The amplitude of Voice 1 at the final output is a function 
of the Envelope Generator only. 

NOTE: The oscillator output waveforms are NOT additive. If more 
than one output waveform ts selected simultaneously, the result will 
be a logical ANDing of the waveforms. Although this technique can 
be used to generate additional waveforms beyond the four listed 
above, it must be used with care. If any other waveform is selected 
while Noise is on, the Noise output can "lock up." If this occurs, the 
Noise output will remain silent until reset by the TEST bit or by 
bringing RES (pin 5) low. 



ATTACK/DECAY (Register 05) 

Bits 4-7 of this register (ATK0-ATK3) select 1 of 16 ATTACK rates for 
the Voice 1 Envelope Generator. The ATTACK rate determines how rapidly 
the output of Voice 1 rises from zero to peak amplitude when the Envelope 
Generator is Gated. The 16 ATTACK rates are listed in Table 2. 
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Bits 0-3 (DCYO— DCY3) select 1 of 16 DECAY rates for the Envelope 
Generator. The DECAY cycle follows the ATTACK cycle and the DECAY 
rate determines how rapidly the output falls from the peak amplitude to 
the selected SUSTAIN level The 16 DECAY rates are listed in Table 2. 

SUSTAIN/RELEASE (Register 06) 

Bits 4-7 of this register (STNO— STN3) select 1 of 16 SUSTAIN levels 
for the Envelope Generator. The SUSTAIN cycle follows the DECAY cycle 
and the output of Voice 1 will remam at the selected SUSTAIN amplitude 
as long as the Gate bit remains set. The SUSTAIN levels range from zero 



Table 2. Envelope Rates 



VALUE 


ATTACK RATE 


DECAY/RELEASE 






RATE 


DEC (HEX) 


(Time/Cycle) 


(Time/Cycle) 


(0) 


2 ms 


6 ms 


1 (1) 


8 ms 


24 ms 


2 (2) 


16 ms 


48 ms 


3 (3) 


24 ms 


72 ms 


4 (4) 


38 ms 


114 ms 


5 (5) 


56 ms 


168 ms 


6 (6) 


68 ms 


204 ms 


7 (7) 


80 ms 


240 ms 


8 (8) 


100 ms 


300 ms 


9 (9) 


250 ms 


750 ms 


10 (A) 


500 ms 


1.5 s 


11 (B) 


800 ms 


2.4 s 


12 (C) 


1 s 


3s 


13 (D) 


3s 


9 s 


14 (E) 


5 s 


15 s 


15 (F) 


8s 


24 s 



NOTE: Envelope rates are based on a 1.0-MHz <^2 clock. For other 
ct)2 frequencies, multiply the giveri rate by 1 The rates refer 

to the amount of time per cycle. For example, given an ATTACK 
value of 2, the ATTACK cycle would take 16 ms to rise from zero to 
peak amplitude. The DECAY/RELEASE rates refer to the amount of 
time these cycles would take to fall from peak amplitude to zero. 
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to peak amplitude in 16 linear steps, with a SUSTAIN value of selecting 
zero amplitude and a SUSTAIN value of 15 ($F) selecting the peak am- 
plitude. A SUSTAIN value of 8 would cause Voice 1 to SUSTAIN at an 
amplitude one-half the peak amplitude reached Dy the ATTACK cycle. 

Bits 0-3 (RLS0-RLS3) select 1 of 16 RELEASE rates for the Envelope 
Generator. The RELEASE cycle follows the SUSTAIN cycle when the 
Gate bit is reset to zero. At this time, the output of Voice 1 will fall from 
the SUSTAIN amplitude to zero amplitude at the selected RELEASE rate. 
The 16 RELEASE rates are identical to the DECAY rates. 

NOTE: The cycling of the Envelope Generator can be altered at any 
point via the Gate bit. The Envelope Generator can be Gated and 
Released without restriction. For example, if the Gate bit is reset 
before the envelope has finished the ATTACK cycle, the RELEASE 
cycle will immediately begin, starting from whatever amplitude had 
been reached. If the envelope is then gated again (before the RE- 
LEASE cycle has reached zero amplitude), another ATTACK cycle 
will begin, starting from whatever amplitude had Deen reached. This 
technique can be used to generate complex amplitude envelopes 
via real-time software control 



Voice 2 

Registers 07-$0D control Voice 2 and are functionally identical to registers 
00-06 with these exceptions: 

1) When selected. SYNC synchronizes Oscillator 2 with Oscillator 1. 

2) When selected, RING MOD replaces the Tnangle output of Oscillator 2 with 
the ring moauiatea combination of Oscillators 2 and 1 



Voice 3 

Registers $0E-$14 control Voice 3 and are functionally identical to reg- 
isters 00-06 with these exceptions: 

1) When selected, SYNC synchronizes Oscillator 3 with Oscillator 2. 

2) When selected, RING MOD replaces the Triangle output of Oscillator 3 with 
the ring modulated combination of Oscillators 3 and 2 

Typical operation of a voice consists of selecting the desired parameters: 
frequency, waveform, effects (SYNC, RING MOD) and envelope rates, 
then gating the voice whenever the sound is desired. The sound can be 
sustained for any length of time and terminated by clearing the Gate bit. 
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Each voice can be used separately, with independent parameters and 
gating, or in unison to create a single, powerful voice. When used in unison, 
a slight detuning of each oscillator or tuning to musical intervals creates 
a rich, animated sound. 

Filter 

FC LO/FC HI (Registers $15,$16) 

Together these registers form an 11 -bit number (bits 3-7 of FC LO are 
not used) which linearly controls the Cutoff (or Center) Frequency of the 
programmable Filter. The approximate Cutoff Frequency ranges from 30 
Hz to 12 KHz. 

RES/FILT (Register $17) 

Bits 4-7 of this register (RES0-RES3) control the resonance of the filter. 
Resonance is a peaking effect which emphasizes frequency components 
at the Cutoff Frequency of the Filter, causing a sharper sound. There are 
16 resonance settings ranging linearly from no resonance (0) to maximum 
resonance (15 or $F). Bits 0-3 determine which signals will be routed 
through the Filter: 

FILT 1 (Bit 0): When set to a zero. Voice 1 appears directly at the audio 
output and the Filter has no effect on it. When set to a one. Voice 1 will 
be processed through the Filter and the harmonic content of Voice 1 will 
be altered according to the selected Filter parameters. 

FILT 2 (Bit 1): Same as bit for Voice 2. 

FILT 3 (Bit 2): Same as bit for Voice 3. 

FILTEX (Bit 3): Same as bit for External audio input (pin 26). 

MODE VOL (Register $18) 

Bits 4-7 of this register select various Filter mode and output options: 

LP (Bit 4): When set to a one, the Low-Pass output of the Filter is selected 
and sent to the audio output. For a given Filter input signal, all frequency 
components below the Filter Cutoff Frequency are passed unaltered, while 
all frequency components above the Cutoff are attenuated at a rate of 12 
dB/Octave. The Low-Pass mode produces full-bodied sounds. 

BP (Bit 5): Same as bit 4 for the Bandpass output. All frequency com- 
ponents above and below the Cutoff are attenuated at a rate of 6 dB/ 
Octave The Bandpass mode produces thin, open sounds. 
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HP (Bit 6): Same as bit 4 for the High-Pass output. All frequency com- 
ponents above the Cutoff are passed unaltered, while all frequency com- 
ponents below the Cutoff are attenuated at a rate of 12 dB/Octave. The 
High-Pass mode produces tinny, buzzy sounds. 

3 OFF (Bit 7): When set to a one, the output of voice 3 is disconnected 
from the direct audio path. Setting Voice 3 to bypass the Filter (FILT 3 ^ 
0) and setting 3 OFF to a one prevents Voice 3 from reaching the audio 
output. This allows Voice 3 to be used for modulation purposes without 
any undesirable output. 

NOTE: The Filter output modes ARE additive and multiple Filter 
modes may be selected simultaneously. For example, both LP and 
HP modes can be selected to produce a Notch (or Band Reject) 
Filter response. In order for the Filter to have any audible effect, at 
least one Filter output must be selected and at least one Voice must 
be routed through the Filter, The Filter is, perhaps, the most important 
element in SID as it allows the generation of complex tone colors 
via subtractive synthesis (the Filter is used to eliminate specific fre- 
quency components from a harmonically rich input signal). The best 
results are achieved by varying the Cutoff Frequency in real-time. 



Bits 0-3 (VOL0-VOL3) select 1 of 16 overall Volume levels for the final 
composite audio output The output volume levels range from no output 
(0) to maximum volume (15 or $F) in 16 linear steps. This control can be 
used as a static volume control for balancing levels in multi-chip systems 
or for creating dynamic volume effects, such as Tremolo. Some Volume 
level other than zero must be selected in order for SID to produce any 
sound. 



Miscellaneous 

POTX (Register $19) 

This register allows the microprocessor to read the position of the poten- 
tiometer tied to POTX (pin 24), with values ranging from at minimum 
resistance, to 255 ($FF) at maximum resistance. The value is always valid 
and is updated every 512 <|)2 clock cycles. See the Pin Description section 
for information on pot and capacitor values. 

POTY (Register $1A) 



Same as POTX for the pot tied to POTY (pin 23). 
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OSC 3/RANDOM (Register $1B) 

This register allows the microprocessor to read the upper 8 output bits of 
Oscillator 3. The character of the numbers generated is directly related to 
the waveform selected. If the Sawtooth waveform of Oscillator 3 is se- 
lected, this register will present a series of numbers incrementing from 
to 255 ($FF) at a rate determined by the frequency of Oscillator 3. if the 
Triangle waveform is selected, the output will increment from up to 255, 
then decrement down to 0. If the Pulse waveform is selected, the output 
will jump between and 255. Selecting the Noise waveform will produce 
a series of random numbers, therefore, this register can be used as a 
random number generator for games. There are numerous timing and 
sequencing applications for the OSC 3 register, however, the chief function 
is probably that of a modulation generator. The numbers generated by 
this register can be added, via software, to the Oscillator or Filter Fre- 
quency registers or the Pulse Width registers in real-time. Many dynamic 
effects can be generated in this manner. Siren-like sounds can be created 
by adding the OSC 3 Sawtooth output to the frequency control of another 
oscillator. Synthesizer "Sample and Hold" effects can be produced by 
adding the OSC 3 Noise output to the Filter Frequency control registers. 
Vibrato can be produced by setting Oscillator 3 to a frequency around 
7 Hz and adding the OSC 3 Triangle output (with proper scaling) to the 
Frequency control of another oscillator. An unlimited range of effects are 
available by altenng the frequency of Oscillator 3 and scaling the OSC 3 
output. Normally, when Oscillator 3 is used for modulation, the audio output 
of Voice 3 should be eliminated (3 OFF = 1). 

EN V 3 (Register $1C) 

Same as OSC 3, but this register allows the microprocessor to read the 
output of the Voice 3 Envelope Generator. This output can be added to 
the Filter Frequency to produce harmonic envelopes, WAH-WAH, and 
similar effects. "Phaser" sounds can be created by adding this output to 
the frequency control registers of an oscillator. The Voice 3 Envelope 
Generator must be Gated in order to produce any output from this register. 
The OSC 3 register, however, always reflects the changing output of the 
oscillator and is not affected m any way by the Envelope Generator. 
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6525 Tri-Port Interface 

Concept 

The 6525 TRI-PORT Interface (TPI) is designed to simplify the imple- 
mentation of complex I/O operations in microcomputer systems. It com- 
bines two dedicated 8-bit I/O ports with a third 8-bit port programmable 
for either normal I/O operations or priority interrupt/handshaking control. 
Depending on the mode selected, the 6525 can provide 24 individually 
programmable I/O lines or 16 I/O lines, 2 handshake lines and 5 priority 
interrupt inputs. 



6525 Addressing 

6525 REGlSTERS/(Direct Aaoressing) 



*000 


RO 


PRA— Poa Register A 


001 


R1 


PRB— Port Register B 


010 


R2 


PRC— Port Register C 


011 


R3 


DDRA— Data Direction Register A 


100 


R4 


DDRB— Data Direction Register B 


101 


R5 


DDRC— Data Direction Register C/lnterrupt Mask Register 


110 


R6 


CR— Control Register 


111 


R7 


AIR— Active Interrupt Register 



*NOTE. RS2, RSI, RSO respectively 



6525 Control Registers 



CR 


CBi 


CBo 


CAi 


CAo 


IE4 


IE3 


IP 


MC 


AIR 








A4 


A3 


A2 


Ai 


Ao 


DDRC 

When MC = 1 








M4 


M3 


M2 


Mi 


Mo 


















PRC 


CB 


CA 


IRQ 


I4 


is 


I2 


I1 


lo 



CA, CB Functional Description 



The CA, CB lines are outputs used in the sanne fashion as the CA2 and 
CB2 output of the 6520. 
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CA Output Modes 



CAi CAo 



MODE 



DESCRIPTION 















1 



1 
1 1 



"Handshake" 
on Read 



Pulse Output 



Manual 
Output 

Manual 
Output 



CA IS set high on an active transition of the I3 
interrupt input signal and set low by a micropro- 
cessor "Read A Data" operation This allows 
positive control of data transfers from the pe- 
ripheral device to the microprocessor. 

CA goes low for IMS after a "Read A Data" op- 
eration This pulse can be used to signal the 
peripheral device that data was taken. 

CA set low 
CA set high. 



CB Output Modes 



CB"! CBo 



MODE 



DESCRIPTION 











"Handshake" 
on Write 



Pulse Output 



Manual 
Output 

Manual 
Output 



CB is set low on microprocessor "Write B Data" 
operation and is set nigh by an active transition 
of the I4 interrupt input signal. This allows positive 
control of data transfers from the microprocessor 
to the peripheral device. 

CB goes low for IMS after a microprocessor "Write 
B Data" operation. This can be used to signal 
the peripheral device that data is available. 

CB set low. 
CB set high. 



INTERRUPT MASK REGISTER DESCRIPTION 

When the Interrupt Mode IS selected (MC 1), the Data Direction Register 
for Port C (DDRC) is used to enable or disable a corresponding interrupt 
input. For exannple: If Mq = then Iq is disabled and any Iq interrupt latched 
in the interrupt latch register will not be transferred to the AIR and will not 
cause IRQ to go low. The interrupt latch can be cleared by writing a zero 
to the appropriate I bit in PRC. 
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PORT REGISTER C DESCRIPTION 

Port Register C (PRC) can operate in two modes. The mode is controlled 
by bit MC in register CR. When MC = 0, PRC is a standard I/O port, 
operating identically to PRA & PRB. If MC = 1 , then port register C is 
used for handshaking and priority interrupt input and output. 



PRC When MC = 0: 

)_ 



PC7 


PCe 


PCs 


PC4 


PC3 


PC2 


PCi 


PCo 


PRC When MC = 1 : 


CB 


CA 


IRQ 


U 


I3 


I2 


I1 


lo 



INTERRUPT EDGE CONTROL 

Bits IE4 and IE3 in the control register (CR) are used to determine the 
active edge which will be recognized by the interrupt latch. 

If IE4 (IE3) = then I4 (I3) latch will be set on a negative transition of U 
(I3) input. 

If \Ea (IE3) = 1 then I4 (I3) latch will be set on a positive transition of the 
I4 (I3) input. 

All other interrupt latches (I2, I1, lo) are set on a negative transition of the 
corresponding interrupt input. 

Interrupt Latch Register 

^ . I Clears on Read of AIR Using Following 

I4 I3 I2 I1 lo Equation 

ILR ^ ILR © AIR 



A4 A3 A2 A-t Aq 



Active Interrupt Register 

Clears on Write to AIR 

Interrupt Priority Select 

IP = No Priority 



IP = 1 Interrupts Prioritized 
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FUNCTIONAL DESCRIPTION 

1. IP = No Priority 

All interrupt information latched into interrupt latch register (ILR) is im- 
mediately transferred into active interrupt register (AIR) and IRQ is pulled 
low. Upon read of interrupt the IRQ is reset high and the appropriate bit(s) 
of the interrupt latch register is cleared by exclusive OR-ing. The ILR with 
AIR (ILR0AIR). After the appropriate interrupt request has been serviced 
a Write to the AIR will clear it and initiate a new interrupt sequence if any 
interrupts were received dunng previous interrupt servicing In this non- 
prioritized mode it is possible for two or more interrupts to occur simul- 
taneously and be transferred to the AIR. If this occurs it is a software effort 
to recognize this and act accordingly. 

2, IP = 1 Interrupts Prioritized 

In this mode the Interrupt Inputs are prioritized in the following order U > 

I3 > I2 > li > lo 

In this mode only one bit of the AIR can be set at any one time. If an 
interrupt occurs it is latched into the interrupt latch register, the IRQ line 
is pulled low and the appropriate bit of the AIR is set. To understand fully 
the operation of the pnority interrupts it is easiest to consider the following 
examples. 

A. The first case is the simplest. A single interrupt occfirs and the pro- 
cessor can service it completely before another interrupt request is 
received. 

1. Interrupt I1 is received. 

2. Bitji is set high in Interrupt Latch Register. 

3. IRQ is pulled low. 

4. Ai is set high. 

5. Processor recognizes IRQ and reads AIR to determine which in- 
terrupt occurred. 

6. Bit I1 IS reset and IRQ is reset to high. 

7. Processor Services Interrupt and signals completion of Service 
routine by writing to AIR. 

8. Ai is reset low and interrupt sequence is complete. 

B. The second case occurs when an interrupt has been received and a 
higher priority interrupt occurs. (See Note) 

1. Interrupt I1 is received. 

2. B_it [1 is set high on the Interrupt Latch Register. 

3. IRQ is pulled low and Ai is set high. 
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4. Processor recognizes IRQ and reads AIR to determine which 
interrupt occurred. 

5. Bit li is reset and IRQ is reset high. 

6. Processor begins servicing interrupt and the I2 interrupt is re- 
ceived. 

7. A2 is set, Ai is reset low and IRQ is pulled low. 

8. Processor has not yet completed servicing 1^ interrupt so this 
routine will De automatically stacked in 6500 stack queue when 
new IRQ for I2 of interrupt is received. 

9. Processor reads AIR to determine I2 interrupt occurrence and bit 
I2 of interrupt latch is reset. 

10. Processor services I2 interrupt, clears A2 by writing AIR and re- 
turns from interrupt. Returning from interrupt causes 650X pro- 
cessor to resume servicing interrupt. 

11. Upon clearing A2 bit in AIR, the Ai bit will not be restored to a 
one. Internal circuitry will prevent a lower priority interrupt from 
interrupting the resumed h. 

C. The third case occurs when an interrupt has been received and a 
lower priority interrupt occurs. 

1. [nlorrupt I1 is received and latched. 

2. IRQ is pulled low and AJs set high. 

3. Processor recognizes IRQ and reads AIR to determine that 1^ in- 
terrupt occurred. 

4. Processor logic servicing I1 interrupt during which Iq interrupt oc- 
curs and is latched. 

5. Upon completion of I1 interrupt routine the processor writes AIR 
to clear Ai to signal 6525 that interrupt service is complete. 

6. Latch Iq interrupt is transferred to AIR and IRQ is pulled low to 
begin new interrupt sequence. 



NOTE: It was indicated that the 6525 will maintain Priority Interrupt 
information from previously serviced interrupts. 

This is achieved by the use of an Interrupt Stack. This stack is pushed 
whenever a read of AIR occurs and is pulled whenever a write to 
AIR occurs. It is therefore important not to perform any extraneous 
reads or writes to AIR since this will cause extra and unwanted stack 
operations to occur. 

The only time a read of AIR should occur is to respond to an interrupt 
request. 

The only time a write of AIR should occur is to signal the 6525 that 
the interrupt service is complete. 



J 

Disk User's 
Guide 

The optional disk holds programs supplementary to the book. 

The programs are as follows: 

SUPERMONl (for original ROM PET computers) 
SUPERMON5(for upgrade ROM PET/CBM computers) 
SUPERMONL (for 4.0 PET/CBM computers) 
SUPERMON . V (for VIC-20 computers) 
SUPERMONt^ (for Commodore 64 computers) 
SUPERMON INST (instructions, BASIC) 
UNICOPYt^ (for Commodore 64) 
UNICOPY INST (instructions, BASIC) 
JUNICOPY LIST (BASIC, all machines) 
UNICOPY ASSY (data file for UNICOPY LIST) 
COPY-ALL (for PET/CBM) 
COPY-ALL . (for Commodore 64) 
CROSS REF (for PET/CBM) 
CROSS REF (for Commodore 64) 
FACTORS (for PET/CBM) 

FACTORS Vt^ (for VIC-20, Commodore 64, and PLUS/4) 
PENTOMINOS INST (instructions) 
PENTOMINOS (BASIC, all machines) 
PENTOMINOS PET (for PET/CBM) 

PENTOMINOS Vt^ (for VIC-20, Commodore 64, and PLUS/4) 
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PENTOMINOS Bl^fl (boot for B128 system) 

+ PENT012fl (program for B128) 

+ XFER (transfer sequence for B128) 

STRING* THING (BASIC, for PET/CBM) 

STRING THING Vt^ (BASIC, for VIC-20, Commodore 64) 

JSAMPLE FILE (for use with STRING THING) 

These programs are public domain, and may be obtained from user groups. 
They are available here for user convenience. 

The following notes may be useful in using or studying the programs. 

SUPERMONl (for original ROM PET computers) 
SUPERM0N2 (for upgrade ROM PET/CBM computers) 
SUPERMONL (for 4.0 PET/CBM computers) 
SUPERMON . V (for VIC-20 computers) 
SUPERMONfc^ (for Commodore 64 computers) 
SUPERMON INST (instructions, BASIC) 

Supermon 2 and 4 are "extensions" to the built-in MLM of the respective 
machines. The other Supermon versions are complete monitors. 

Remember that the programs on disk are "monitor generators," that is, 
they build the monitor for you. After the monitor has been built, you should 
remove the builder program so that you don't end up with two copies. In 
other words, after RUN type .X to return to BASIC, NEW to scrap the 
builder, and then SYS^ or SYSfl to return to the monitor whenever de- 
sired. 

The monitor is always built near the top of memory. Its entry address can 
be determined by checking the TOM (top-of-memory) pointer. Monitors 
are complex, but feel free to ask the monitor to disassemble itself for your 
information. 

After Supermon is placed, you may load BASIC programs and use the 
computer normally. Supermon will remain until you shut off the power. 

UNICOPYfc^ 

A utility for copying files from one disk to another, on a single drive; or 
copying from one disk to cassette tape. The program is written entirely in 
machine language, apart from the SYS that starts it up. 

Information is copied from the selected files into RAM memory. When the 
output phase begins, the data is then written to disk or tape. 

UNICOPY INST 

A BASIC program explaining how to use UNICOPYt^. 
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UNICOPY LIST 
]UNICOPY ASSY 

An assembly listing of program UNICOPY. Because UNICOPY is written 
entirely in machine language, a number of tasks are performed in the 
program that are often more conveniently done in BASIC. For example, 
files are opened and closed by machine language. This makes the program 
listing particularly interesting for students of these techniques. 

Assembly listings have a somewhat different appearance from the machine 
language programs this book has dealt with. The most visible difference 
IS in the use of symbolic addresses. If there is any confusion, concentrate 
on the machine language half of the listing; that will clarify what's going 
on. Program UNICOPY LIST allows output to the screen or to a Com- 
modore printer. 

For cassette tape output, direct calls to the ROM routines are made; that's 
usually not good practice, but there's little choice here. 

The program is written in machine language so that the BASIC ROM can 
be flipped out, allowing for more memory space in which to copy programs. 

COPY-ALL (for PET/CBM) 
COPY-ALL . (for Commodore 64) 

A utility for copying files from one disk drive to another. You will find two 
SYS commands in the BASIC part of the program: one to get the directory, 
and the other to do the actual copying. 

Information is copied from the selected file into a BASIC string that has 
been set aside for the purpose. A similar technique may be found in the 
simpler STRING THING. 

CROSS REF (for PET/CBM) 
CROSS REF b< (for Commodore 64) 

This program prepares a cross-reference listing for any selected BASIC 
program on disk. It cross-references both line numbers and variables. It's 
a good way to document a BASIC program. 

The program uses two table lookup techniques that may be confusing to 
the beginning machine language program reader. First, it classifies all 
characters received from BASIC in terms of "type"; this is done with a 
table of 256 elements, one for each possible character. Second, it uses 
a "state transition table" to record the nature of the job in progress; for 
example, after meeting a GO SUB "token," it will expect to receive a line 
number. 
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The second SYS in the BASIC program is used to print the line numbers 
of the cross-reference. It employs an efficient bmary-to-decimal conversion 
technique, which uses decimal mode. 

FACTORS (for PET/CBM) 

FACTORS Vb^ (for VIC-20, Commodore 64, and PLUS/4) 

This program finds factors of numbers up to nineteen digits long. This 
shows a powerful feature of machine language as opposed to BASIC" the 
size of numbers is not limited by the language. 

The program contains a number of useful techniques worth studying. First, 
it allows decimal input of any number up to 19 digits (a 64-bit or 8-byte 
binary number). Second, to find factors it performs division with remainder. 
Finally, to print results, it must convert binary-to-decimal, using the same 
decimal mode technique as m CROSS REF 

The program does not try all divisors. After trying a few initial values (E, 
3, and 5). it switches to a "30-counter" technique, trying only multiples 
of 3D plus 1, ?, 11, 17, IS, E3, and ES. 

The machine language program is relocated by BASIC so that it starts at 
hexadecimal 1 3 □ □ regardless of where it was originally loaded. This was 
originally done to allow for the VIC-20's variable start-of-BASIC, which 
rambles according to the amount of extra memory fitted. It turns out to be 
useful for studying to have the program m a fixed location; so the 
PET/CBM version was also set up in this way. 

Students wishing to disassemble FACTORS will find the following infor- 
mation useful: 

VARIABLES: 

$D3<H — number of times a factor divides evenly 
$D3< A — "equals" or "asterisk" character for formatting 
$D3<B — zero suppression flag 
$D3<C— 30-counter 

$D3 5D to $D3 57— value under analysis 

$D3 5fi to $D3 5F— value work area 

$D3bD to $D3b7— "base" value for 30-counter 

$D3bC to $ 03 7 division work area, including: 

$D3bC to $D3bF— remainder 

$□370 to $ 03 7 7— quotient 

PROGRAM. 

$13DD: Mam routine, including: 
$ 1 3 □ □ : Start, clear work area 
$131D : Get number digits from user 
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$1331 : Handle bad input 

$133 A ; Begin factoring; check non-zero 

$135D : Try divisors 2, 3, and 5 

$13 b5: Try higher divisors 

$13AE : Print remaining value. 

$13BA: Prompt subroutine 

$13C<: Input and analyze digit 

$ 1< □ B : Multiply-by-two subroutine 

$1<15: Division subroutine 

$1<7A: Try a divisor (short) 

$1<7D: Try a divisor (long) 

$l<fi5: Check if remainder zero 

$ 1 ^ S E : Log factor if found 

$1<AE : Check if more to do 

$1<BS: Print value subroutine 

$1<DD: Print factor subroutine 

$15D<: Clear output area 

$15DF: Convert to decimal and print 

$1535 : Print a digit with zero suppression 

$15b5; 30-count values: 1. 7,. 11, etc. 



Even at machine language speeds, this program can take a long time to 
analyze large factors and prime numbers. The RUN/STOP key is active 
to allow the user to stop the run. 



PENTOMINOS INST (instructions) 
PENTOMINOS (BASIC, all machines) 
PENTOMINOS PET (for PET/CBM) 

PENTOMINOS Vb< (for VIC-20, Commodore 64, and PLUS/4) 
PENTOMINOS BlEfi (boot for B128 system) 
+ PENT01Efi (program for B128) 
+ XFER (transfer sequence for 81 28) 

A puzzle solving problem. Pieces are fitted into a selected rectangular 
shape "visibly *— in other words, they may be seen on the screen as they 
are tried. 

The machine language programs follow the logic of the BASIC program 
precisely. The "shape tables" have been rearranged for greater machine 
language convenience (each piece is reached by indexing; the index range 
of □ to E 55 dictates the piece being selected and its rotation). 

The machine language program uses no indirect addressing and no sub- 
routines. That is not necessarily good practice; it is largely a result of 
writing the program logic to exactly match the BASIC program. 
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This program makes use of tables, and is worth studying for that reason. 
It is also useful to examine the close relationship between the BASIC 
program and its machine language equivalent, especially starting at line 
2000 in BASIC. 

As with FACTORS, the machine language program is relocated by BASIC 
so that It starts at hexadecimal 15bD (with tables starting at 
regardless of where it was originally loaded. Again, this is necessary for 
the VIC-20 and proves to be convenient for study purposes on all ma- 
chines — except the B-1 28 version, where this relocation does not happen. 

Students wishing to disassemble PENTOMINOS will find the following 
information useful: 

VARIABLES: 

$□ 33 C— piece number, BASIC variable P 

$D33D to $ 03 3E— variables W1 and W2, board size 

$D33F— P1, number of pieces placed 

$03 AD to $D3<B— U(..) log of pieces placed 

$D3<C to $D357— T(..) rotation of piece 

$D35fl to $D35C— X(..) location of piece 

$D35D to $D3t3l— Y(..) location of piece 

$D3bE to $D37 □— tables to place a piece 

$D37F to $D3HC— board "edge" table 

$D3HD to $D3Dfl— B(. . .) the board. 

PROGRAM: 

$15bD : Start, BASIC line 1070 
$15A< : Clear screen, BASIC line 1120 
$15AH : Clear variables, set up 
$15CC: Find space, BASIC line 2010 
SlbDD : Get new piece, BASIC line 2030 
SlbDH : Try piece, BASIC line 2060 
$lbflb: Put piece in, BASIC line 2120 
SlfcED : Print "Solution", BASIC line 2170 
$17D1: Undraw piece, BASIC line 2190 
$17 AB : Rotate piece, BASIC line 2260 
$17BC : Give up on piece, BASIC line 2280 
$17C1 : Look for new piece, BASIC line 2300 

The B128 version does not align to the above addresses. It is written to 
Illustrate the "boot" loading system needed for that computer. Programs 
whose names begin with a + symbol are loaded by the bootstrap program; 
do not try to load them directly. 
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STRING THING (BASIC, for PET/CBM) 

STRING THING Vfc< (BASIC, for VIC-20, Commodore 64, PLUS/4) 
SAMPLE FILE 

A simple machine language program, POKEabie directly from BASIC, to 
substitute for an INPUT# statement. 

INPUT# has several limitations that sometimes make it awkward for use 
with files: 

• No more than 80 characters may be read. 

• The comma or colon character will break up input 

• Leading spaces will disappear 

STRING THING reads everything up to the next RETURN or end of 
file. It is pure BASIC, but POKEs machine language into the cassette 
buffer area. It finds the first variable and uses it as an input buffer. 



Glossary 



The numbers in parentheses indicate the chapter in which the word or 
phrase is first used. 

Absolute address: (5) An address that can indicate any location in 
memory. 

Accumulator: (3) The A register; the register used for arithmetic. 

Address bus: (1) A bus that signals which part of memory is wanted 
for the next memory operation 

Address mode: (5) The manner m which an instruction reaches in- 
formation within memory. 

Address: (1) The identity of a specific location within memory 

Algorithm: (1) A method or procedure to perform a computing task 

Arithmetic shift or rotate: (4) A shift or rotate that usually preserves 
the sign of a number. 

Assembler: (2) A program that assembles or changes source code 
into object code. 

Assembly: (1 ) The process of changing source code into object code. 

Assembly code: (1) Also called source code A program written in a 
somewhat human-readable form. Must be translated ("assembled") before 
use. 
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Assembly language: (1 ) The set of instructions, or language, in which 
a source progrann nnust be written before assennbly. 

Binary: (1) Sonnething that has two possible states; a nunnber based 
on digits, each of which has two possible states. 

Bit: (1) A binary digit; the smallest elennent of information within a 
computer. 

Bootstrap: (6) A program that starts up another program. 
Breakpoint: (8) A location where the program will stop so as to allow 
checking for errors. 

Bug: (8) An error within a program. 

Bus: (1) A collection of wires connecting many devices together. 

Byte: (1) Eight bits of information grouped together; the normal mea- 
sure of computer storage. 

Calling point: (2) The program location from which a subroutine is 
called into play; the subroutine will return to the calling point when finished. 

Channel: (8) A path connecting the computer to one of its external 
devices. 

Comment: (8) A program element which does not cause the computer 
to do anything, used as advice to the human program reader. 

Commutative: (3) A mathematical operation that works both ways, 
e.g., 3 + 4 gives the same result as 4 + 3. 

Control bus: (1) A bus that signals timing and direction of data flow 
to the various connected devices. 

Data bus: (1) A bus used to transfer data between memory and the 
microprocessor. 

Debugging: (8) Testing a program to uncover possible errors. 

Decimal: (1) A number system based on a system of ten digits; the 
"normal" numbering system used by humans. 

Decrement: (2) To make smaller by a value of one. 

Descriptor: (6) A three-byte set of data giving a string's length and 
its location. 

Disassembler: (2) A program that changes object code into assembly 
code to allow inspection of a program. 

Disassemble: (2) To change object code into assembly code. Similar 
to a LIST in BASIC. 

Dynamic string: (6) A string that must be placed into memory after 
being received or calculated. 

Effective address: (2) The address used by the processor to handle 
data when executing an instruction. It may differ from the instruction ad- 
dress (or "operand") because of indexing or indirect addressing. 

Event flag: (7) A flag that signals that some event has happened. 

Execute: (1) To perform an instruction. 
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File: (8) A collection of data stored on some external device. 

Flag: (3) An on/off indicator that signals some condition. 

Floating accumulator: (7) A group of memory locations used by BASIC 
to perform calculations on a number. 

Garbage collection: (6) A BASIC process in which active strings are 
gathered together and inactive strings are discarded. On some computers 
this can be quite time consuming. 

Increment: (2) To make larger by a value of one. 

index: (2) To change an address by adding the contents of an index 
register. 

index register: (2) The X or Y registers, which may be used for chang- 
ing effective addresses. 

Indirect address: (5) An addressing scheme whereby the instruction 
contains the location of the actual address to be used; an address of an 
address. 

Instruction: (1 ) An element of a program that tells the processor what 
to do. 

Interrupt: (1) An event that causes the processor to leave its normal 
program so that some other program takes control, usually temporarily. 

Interrupt enable register: (7) A location within an lA chip that deter- 
mines whether or not a selected event will cause an interrupt. 

Interrupt flag: (7) A signal within the lA indicating that a certain event 
has requested that an interrupt take place. 

Interrupt flag register: (7) A location within the lA where interrupt 
events can be detected and turned off if desired. 

Interrupt source: (7) The particular event that caused an interrupt. 
Since many things can do this, it's usually necessary to identify the specific 
source of the interrupt. 

Kernel: (2) Commodore's operating system. 

Label, symbolic address: (8) A name identifying a memory location. 

Latcfi: (7) A flag that "locks in." 

Load: (1) To bring information from memory into the processor. A 
load operation is a copying activity; the information still remains in memory. 

Logical file number: (8) The identity of a file as used by the program- 
mer. 

Logical operator: (3) An operation that affects individual bits within a 
byte: AND, ORA, and EOR. 

Logical sfiift or rotate: (4) A shift that does not preserve the sign of 
assigned number. 

l\/lachine code: (1) Instructions written in machine language. 

l\/lachine language: (1) The set of commands that allow you to give 
instructions to the processor. 
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Machine language monitor (1 ) A program that allows communication 
with the computer in a manner convenient for machine language pro- 
gramming. 

Memory: (1) The storage used by a computer; every location is iden- 
tified by an address. 

Memory mapped: (1) Circuits that can be reached by the use of a 
memory address, even though they are not used for storage or memory 
purposes. 

Memory page: (5) A set of 256 locations in memory, all of whose 
addresses have the same "high byte." 

Microcomputer: (1 ) A computer system containing a microprocessor, 
memory, and input/output circuits. A computer built using microchips. 

Microprocessor: (1) The central logic of a microcomputer, containing 
logic and arithmetic. A processor built on a microchip. 

Monitor: (1 ) A program that allows the user to communicate with the 
computer. Alternatively, a video screen device. 

Non-maskable interrupt, NMI: (7) A type of interrupt that cannot be 
disabled. 

Non-symbolic assembler: (2) An assembler m which actual addresses 
must be used. 

Object code: (1) The machine language program that will run in the 
computer. 

Octothorpe: (2) Sometimes called a numbers sign, a pounds sign, a 
hash mark. The symbol. 

Operand: (1) The part of an instruction following the op code that 
usually signals where in memory the operation is to take place. 

Operating system: (1) A set of programs with a computer that takes 
care of general work such as input/output, timing, and so on 

Operation code, op code: (1) The part of an instruction that says 
what to do. 

Overflow: (3) Condition caused by an arithmetic operation generating 
a result that is too big to fit in the space provided. 

Pointer: (6) An address held in memory, usually in two bytes. 

Processor status word, status register: (3) A processor register that 
holds status flags. 

Pull: (7) To take something from the stack. 

Push: (7) To put something on the stack. 

Random access memory, RAM: (1 ) The part of a computer's memory 
where information can be stored and recalled. 

Read: (1) To obtain information from a device. 

Read only memory, ROM: ( 1 ) The part of a computer's memory where 
fixed information has been stored. New information cannot be stored in a 
ROM; it is preprogrammed. 
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Register: (1) Location within a processor where information can be 
held temporarily. 

Screen editing: (1) The ability to change the screen of a computer 
and cause a corresponding change in memory 

Screen memory: (2) The part of a computer holding the information 
displayed on the screen. Changing screen memory will change the screen; 
reading screen memory will reveal what is on the screen. 

Selected: (1) A chip or device that has been signaled to participate 
in a data transfer. If the chip or device has not been selected, it will ignore 
data operations. 

Self-modifying: (7) A type of program that changes itself as it runs. 
Rare, and not always considered good programming practice 

Signed number: (3) A number that holds a value that may be either 
positive or negative. 

Source code: (1) Instructions written in assembly language; usually, 
the first code written by the programmer before performing an assembly. 

Stack: (7) A temporary, or "scratch pad," set of memory locations. 

Status register, processor status word: (3) Within the processor, a 
register that holds status flags. 

Store: (1) To transfer information from the processor to memory. The 
store operation is a copying activity, the information still remains in the 
processor. 

Subroutine: (2) A set of instructions that can be called up by another 
program 

Symbolic address, label: (7) A name identifying a memory location. 

Symbolic assembler: (2) An assembler in which symbolic addresses 
may be used. This is more powerful than a non-symbolic assembler. 

Testable flag: (3) A flag that can be tested by means of a conditional 
branch instruction. 

Two's complement: (3) A method of representing negative numbers. 
With single byte numbers, -1 would be represented by $FF. 

Unsigned number: (3) A number that cannot have a negative value. 

Write: (1) To send information to a device. 

Zero page: (5) The lowest 256 locations in memory. Locations whose 
addresses begin with hexadecimal $00. . . 
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A, X, and Y data registers, 9, 11, 46, 47, 
142 

Absolute addressing, 148 

Absolute indexed mode, 77-78 

Absolute indirect, 149 

Absolute mode, 75-76 

Accumulator addressing, 148 

Accumulator mode, 74 

ADC, Add memory to accumulator with 

carry, 149 
Addition, 58-60 
Address bus, 3-5 
Address defined, 3 
Addressing modes, 72-89, 148-149 
Algorithms, 

decimal to hexadecimal, 7 

hexadecimal to decimal, 7 
AND, "AND" memory with accumulator, 

121, 149 
ASCII, 25, 50, 223-224 
Assemblers, 

nonsymbolic, 27 

Symbolic, 143-144 
ASL, Shift left one bit (memory or 
accumlator), 61-62, 149 



— B— 

BASIC, 
breaking into, 124-125 
infiltrating, 122-124 
linking with, 30-31 

machine language exchanging data, 
104-108 

memory layout, 92-102 

variables, 102-105 
BCC, Branch on carry clear, 87, 149 
BCS, Branch on carry set, 149 
BEQ, Branch on result zero, 149 
Binary defined, 2 
Bit defined, 2 

Bit map mode on the 6566/6567, 280-282 
BIT, Test bits in memory with 

accumulator, 149 
BMI, Branch on result minus, 149 
BNE, Branch on result not zero, 149 
BOS, Bottom of string, 94 
BPL, Branch on result plus, 149 
Branch instructions, 141 
Branches and branching, 79-80 
BRK, Force break, 72, 115, 116, 142 

143, 149, 233 

Bus, 
address, 4-5 



control, 5 

defined, 3 

see also data bus 
BVC, Branch on overflow clear, 150 
BVS, Branch on overflow set, 150 
Bytes, multiple, 58 



-C- 

C flag, 42, 45, 46 

Character display mode of the 

6566/6567, 277-279 
Character sets, 216-224 
Chip information, 245-308 
6520 (PIA) Peripheral interface 

adaptor, 246-250 
6522 (ViA) Versatile interface adaptor, 
261-270 

6525 Tri-port interface, 304-308 

6526 (CIA) Complex interface adap- 
tor, 270-277 

6545-1 (CRTC) CRT controller, 251-256 
6560 (VIC) video interface chip, 
256-261 

6566/6567 (VIC II) chip specifications, 
277-292 

6581 (SID) Sound interface device, 
chip specification, 292-303 
CHKIN subroutine, 136, 137 
CHKOUT subroutine, 133, 134 
CLRCHN subroutine, 136 
CHRGET subroutine, 122, 124 
CHRGOT subroutine, 123, 124 
CHROUT subroutine, 25, 133 
CIA chip, 121 
CLC, Clear carry flag, 150 
CLD, Clear decimal mode, 150 
CLI, clear interrupt disable bit, 118 
Clock speed, 132 
CLOSE, 134 

CLRCHN subroutine, 133, 135, 137 
CLV, Clear overflow flag, 150 
CMP, Compare memory and 

accumulator, 150 
Color codes of the 6566/6567, 292 
Commodore computers, characteristics 

of, 156-159 
Compare, 141 
Comparing numbers, 61-62 
Complex interface adaptor 6526, 121, 

270-277 
Control bus, 5 

CPX, Compare memory and index X, 150 
CPY, Compare memory and index Y, 150 
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-D- 

Data bus, 4-5 
see also Bus 

Data exchange, BASIC machine 

language, 104-108 
Debugging, 142-143 
DEC, Decrement memory by one, 150 
Decimal notation to hexadecimal, 7-8 
DEX, Decrement index X by one, 150 
DEY, Decrement index Y by one, 150 
Disassembler, checking the, 29-30 
Disk user's guide, 310-315 
Division by two, 63-64 
Do nothing instruction, 72-74 
DRA, logical operator, 121 
Dynamic string, 94 

— E— 

Effective address, 32 

End of BASIC, 92 

Envelope rates of the 6581, 299 

EGA, end of arrays, 93 

EGR, exclusive or, 47, 48, 49, 121, 150 

EGR instruction, 87 

Exercises, 11-13, 52-54, 84-88, 226-232 

adding a command, 124, 230 

interrupt, 119, 228-229 

print, 26-27 
Extended color mode of the 6566/6567, 
280 

— F— 

File transfer program, 138-141 
Flags, 40-46 

Floating point variables, 103 
Free memory, 94-95 

-G- 

GETIN, Gets an ASCII character, 25, 133 
Glossary, 318-322 

-H- 

Handshaking, 270-271 
Hexadecimal notation, 5-6 
Hexadecimal notation to decimal, 6-7 

lA, Interface adaptor chips, 9, 50, 

120-122, 142 
lER, Interrupt enable register, 122 
IFR, Interrupt flag register, 121 
Immediate addressing, 148 
Immediate mode, 74-75 
Implied addressing, 148 



Implied mode, 72-74 
INC, Increment memory by one, 74, 150 
Increment and decrement instructions, 
141 

Index registers, 32 
Indexed absolute addressing, 148 
Indexed indirect addressig, 149 
Indexed indirect mode, 83-84 
Indexed zero page addressing, 148 
Indexing modes, 

absolute, 77-78 

indirect, 81-82 

zero page, 78 
Indirect indexed addressing, 149 
Indirect indexed mode, 81-82 
Infiltrating BASIC, 122-124 
Input, 50-52, 133 
GETIN, 50-51 

switching, 136 
INS, increment, 72 
Instruction execution, 10-11 
Instruction set, 141-142, 147 

alphabetic sequence, 149-151 
Integer variables, 104 
Interface adaptor chips, 9, 50, 120-122, 
142 

Interrupt enable register, 122 
Interrupt flag register, 121 
Interrupt processing, 40 
Interrupt request, 115 
I NX, Increment index X by one, 150 
INY, Increment index Y by one, 150 
IRQ, Interrupt request, 115, 117-118 

— J — 

JMP, Jump to new location, 80-81, 
141, 150 

JSR, Jump to new locating saving 
return address, 114-115, 150 
Jump subroutine, 142 
Jumps in indirect mode, 80-81 

-K- 

Kerrial, 24 

Kernal subroutines, 324 
CHKIN, 137 
CHRGUT, 133, 134 
CHRGUT, 25 
CLRCHN, 136 
GETIN, 51 
STGP, 52 

-L- 

LDA, Load accumulator with memory, 
150 
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LDX, Load index X with memory, 150 

LDY, Load index Y with memory, 150 

Light pen, 287 

LOAD, 100-101, 141 

Logical and arithmetic routines, 141 

Logical operators, 47-50 

Loops, 31-34 

LSR, Shift one bit right (memory or 
accumulator), 63-64, 150 

-M- 

Machine language and BASIC 
exchanging data, 104-108 

Machine language linking with BASIC, 
30-31 

Machine laguage monitor SAVE, 99-100 
Memory coritents 

changing, 17 

displaying, 16-17 
Memory elements, 8-9 
Memory, free, 94-95 
Memory interface of the 6566/6567, 
289-292 

Memory layout, BASIC, 92-102 
Memory maps, 

B series, 197-206 

CBM 8032, 173-174 

Commodore PLUS/4 "TED" chip, 
195-197 

Commodore 64, 185-194 

FAT-40 6545 CRT, controller, 173-174 

"Original ROM" PET, 162-166 

Upgrade and BASIC 4.0 systems, 
166-173 

VIC 20, 175-181 

VIC 6522 usage, 183-184 

VIC 6560 chip, 182 
Microprocessor chips, 650X, 3-4 
MLM commands, 15-16, 99-100 

.G command, 16 

.M command, 16 

.R command, 16 

Save command, 99-100 

.X command, 15 
MLM, Machine language monitors, 14 
238 

Modes, 
absolute indexed, 77-78 
addressing, 72-89 
all of zero page, 78 
indexed, indirect, 83-84 
indirect, indexed, 81-82 
jumps in indirect, 80-81 
no address, 72-74 
no address accumulator, 74 
not quite an address, 74-75 



relative address, 79-80 

single address, 75-76 

zero page, 76-78 
Monitors, 

basic, 13-14 

display, 14-15 

extensions, 27-29 

machine language (MLM), 14 

machine language SAVE, 99-100 
Multi-color character mode of the 

6566/6567, 279 
Multiplication, 62-63 

by two, 61-62 

-N- 

N flag, 42-43, 45, 46 
Non-maskable interrupt (NMI), 115, 118 
NOP, No operation, 72-74, 85, 150 
NOP BRK, No operation, break, false 

interrupt, 142 
Numbers, 

comparing, 61-62 

signed, 43-44, 58 

unsigned, 58 
Numeric variables, 104 

-O- 

Op code ends, 323 

Op codes, single-byte, 323 

OPEN, 133-134 

ORA, "OR" memory with accumulator, 

47, 48, 49, 150 
Output, 133 

controlling, 24-36 

examples of, 135-136 

switching, 133-135 
Overflow, 44 

-P- 

PC, Program control register, 9 
PEEK, 5, 104 

PHA, Push accumulator on stack, 113, 
150 

PHP, Push processor status on stack, 
114, 150 

PIA, Peripheral interface adaptor 6520, 

120, 246-250 
PLA, Pull accumulator from stack, 113, 

114, 150 

PLP, Pull processor status from stack, 

114, 150 
Pointers, fixing, 102 
POKE, 5, 26, 104 
Program, 
entering a, 18-19 



Index 325 



running a, 30 
Programming model, 151 
Programming projects, 11-13, 52-54, 
84-88, 226-232 

adding a command, 124, 230 

interrupt, 119, 228-229 

print, 26-27 
Programs, file transfer, 138-141 
Pull information, 142 
Push information, 142 
Push processor status, 114 

— R— 

RAM, Random access memory, 8 
Register map of the 6566/6567, 290-291 
Registers, 9-10, 17 

A, X, and Y, 9, 11, 46, 47 

index, 32 

status, 45-46 
Relative addressing, 148-149 

mode, 79-80 
ROL, Rotate one bit left (memory or 

accumulator), 62, 150 
ROM, Read only memory, 8-9 

linK 80-81 

ROR, Rotate one bit right (memory or 
accumulator), 63-64, 150 

Rotate, comments, 64-65 

RTL Return from interrupt, 115, 150 

RTS, Return from subroutine, 65, 
114-115, 151 

RUN STOP key. 51-52 

-S- 

6502 Instruction set, 147 

6509 Instruction set, 147 

6510 Instruction set, 147 

6520 (PI A) Peripheral interface adaptor, 
246-250 

6522 (VIA) Versatile interface adapter, 
261-270 

6525 Tri-port interface, 304-308 

6526 (CIA) Complex interface adaptor, 

270-277 

6545-1 (CRTC) CRT controller, 251-256 
6560 (VIC) Video interface chip, 256-261 
6566/6567 (VIC II) chip specifications, 
277-292 

6581 (SiD) Sound interface device, 
chip specifications, 292-303 

7501 Instruction set, 147 

SAVE, 34, 141 
stopgap. 34-35 

SBC, Subtract memory from accumula- 
tor with borrow, 151 

Screen codes, 216-224 



Screen manipulations, 84-88 
Screen rriemory address, 20 
SEC, Set carry flag, 151 
SED, Set decimal mode, 151 
SEI, Set interrupt disabler status, 118, 
151 

Shift and rotate instructions, 61-63, 74 
141 

Shift, comments on, 64-65 
Signed numbers, 43-44, 58 
Single address mode, 75-76 
SOA, Start of arrays, 93 
SOB, Start of basic, 92 
Sound interface device (SID) chip 
specification 6581, 292-303 
SOV, Start of variables, 93, 97-102 
SP, Stack pointer register, 9 
SR, Status register, 9 
STA, Store accumulator in memory, 151 
Stack, 112-115 
Status register, 45-46 
Stop, 25, 51-52 

Stopgap save command, 34-35 

Storage, temporary, 112-115 

String variables, 103 

STX, Store index X in memory, 151 

STY, Store index Y in memory, 151 

Subroutines, 

CHROUT, 25 

GETIN, 25, 50-51 

KERNAL, 24, 324 

prewritten, 24-25 

STOP, 25, 51-52 
Subtraction, 60-61 
Supermom program 27, 238-244 
Symbolic assemblers, 143-144 
SYS, Go to the address supplied, 116 

-T- 

TAX, Transfer accumulator to index X, 
113, 151 

TAY, Transfer accumulator to index Y, 

72, 113, 151 
Testable flags, 40-45 
Time of day clock, 273 
Timing, machine language program, 

132-133 
TOM, Top of memory, 93 
Tri-port interface 6525, 304-308 
TSX, Transfer stack pointer to index X, 

151 

TXA, Transfer index X to accumulator, 
151 

TXS, Transfer index X to stack register, 
151 

TYA, Transfer index Y to accumulator, 
151 



Index 



-U- 

Uncrashing techniques, 234-235. 

Unsigned numbers, 58, 

USR, Go to a fixed addres and execute 

macliine code there as a 

subroutine, 116-117 

— V— 

V Flag, 44, 45, 46 
Variables, 102-105 

VIA, Versatile interface adaptor, 120-121 
VIC II chip specifications 6566/6567, 



277-292 

(VIC) Video interface chip 6560, 256-261 
— W— 

Wedge, 122-124 
program, 124-125 

— Z— 

Z Flag, 40-41, 45, 46 
Zero page addressing, 148 
Zero page mode, 76-78 
indexed, 78 



The six major Kernal subroutines* 

Registers 



Addrs Name 


Action 






Changed 


$FFC6 CHKIN 


Switch input to logical file X 




A,X 


$FFC9 CHKOUT 


SwiTch ouTput TO logical file X 




A,X 


$FFCC CLRCHN 


Restore input/output defaults 






$FFD2 CHROUT 


Output ASCII character in A 




none 


$FFE1 STOP 


Check RUN/STOP key 




A 


$FFE4 GETIN 


Get ASCII character into A 




A,X,Y 


Some Important Memory addresses (hexadecimal): 






Original ROM PET not included. 








Pointers. 


PET/CBM 


VIC 


C64 




Start of Basic 


0028 


002B 


nn?R 




Start of Variables 


002A 


002D 


uu^u 




End of Arrays 


002E 


0031 


UUO I 




Bottom of Strings 


0030 


0033 


0033 




Top of Memory 


0034 


0037 


0037 




Status word ST 


0096 


0090 


0090 




USR jump 


0000 


0000 


0310 




CHRGET subroutine 


0070 


0073 


0073 




Floating accumulator 


005E 


0061 


0061 




Keytouch register 


0097 


OOCB 


OOCB 





